Redvers Consulting Limited 
           Redvers Consulting Limited 
                                   
            Redvers COBOL XML 
                        Interface 
                                    
                                    
                       User Guide 
                                    
                                    
                      Batch Generator 
                 RCCOBXML Version 2.4 
                                   
                                                                
                                   
                                
                                
                         RCCOBXML User Guide 
         
                         Contents 
        Preface....................................................................................................... 5 
        Overview .................................................................................................... 6 
        Installation.................................................................................................. 7 
        Coding the COBOL Record Definition............................................................... 8 
         Field Names.............................................................................................. 8 
          Default Tag Names ................................................................................. 8 
          Override Field Names.............................................................................. 9 
          XML Attributes ....................................................................................... 9 
          XML Namespaces...................................................................................10 
         PICTURE Clause.......................................................................................10 
          Binary / Packed Fields ............................................................................11 
         Other Clauses..........................................................................................12 
          BLANK WHEN ZERO...............................................................................12 
          JUSTIFIED RIGHT..................................................................................12 
          OCCURS...............................................................................................12 
         Clauses Not Supported..............................................................................12 
         Structure.................................................................................................13 
          Mixed Content Elements .........................................................................14 
          Non-tagged group level fields..................................................................14 
         Advanced Techniques................................................................................15 
        Repeating Groups........................................................................................16 
         Using OCCURS.........................................................................................16 
         Using Repeated Calls ................................................................................17 
         Controlling the Point of Change ..................................................................19 
         Orphan Repeats.......................................................................................20 
        Calling RCCOBXML ......................................................................................23 
         Parameters..............................................................................................23 
          COBOL-RECORD (input)..........................................................................23 
          COBOL-RECORD-LENGTH (input).............................................................23 
          FEEDBACK-CODE (output)......................................................................23 
          FEEDBACK-TEXT (output).......................................................................23 
         Calls to RCCOBXML...................................................................................24 
          The First Call.........................................................................................24 
          Subsequent Calls...................................................................................24 
          The Last Call.........................................................................................24 
        Structure Break ..........................................................................................25 
         Normal Operation.....................................................................................25 
         
        Redvers Consulting Limited Page 2 
                                
                                
                         RCCOBXML User Guide 
         
         What is a Structure Break? ........................................................................26 
         How to code a Structure Break...................................................................26 
         When to use a Structure Break...................................................................27 
        Data Integrity.............................................................................................31 
         Character Range ......................................................................................31 
         Character References................................................................................31 
         Entity References .....................................................................................31 
         Empty Elements.......................................................................................32 
         CDATA....................................................................................................32 
         Processing Instructions..............................................................................32 
         Comments...............................................................................................33 
        User Maintained Variables ............................................................................34 
         Program-ID.............................................................................................34 
         CRD-external-file-name.............................................................................34 
         XML-external-file-name.............................................................................34 
         Maximum-XML-record-length.....................................................................35 
         XML-record-format-clause .........................................................................35 
         Maximum-COBOL-record-length .................................................................35 
         XML-declaration and XML-headers ..............................................................35 
         Number-of-XML-headers ...........................................................................35 
         DTD-headers...........................................................................................36 
         Number-of-DTD-headers...........................................................................36 
         Maximum-number-of-fields........................................................................36 
         Maximum-tag-length ................................................................................36 
        Feedback Messages.....................................................................................37 
        Index........................................................................................................41 
         
         
         
         
         
         
         
         
         
        Redvers Consulting Limited Page 3 
                                
                                
                         RCCOBXML User Guide 
         
        ©2002 Redvers Consulting Limited (UK).  All rights reserved. 
         
        Redvers Consulting Limited Page 4