|Developer(s)||Ivandoc Software Services|
|Initial release||May 23, 2011|
V5.0 / May 29, 2012
|Written in||IBM RPG III, RPG IV|
|Operating system||IBM i / AS400|
IvanDoc System is an auto-generator of cross-referencing technical documentation on any application software running in the IBM i / AS400 operating system. Even though the technical documentation is created and generated by programs in the IBM i / AS400 operating system, its various types of technical documents are assessed and viewed vide web browsers and are cross-referenced vide HTML hyperlinks.
- 1 Three main processes of IvanDoc System
- 1.1 First process: Scanning and data collection for the contents of documentation.
- 1.2 Second process: Construction of technical documents with insertion of HTML hyperlinks.
- 1.3 Third process: FTP transfer of technical documents to browser-based operating system.
- 1.4 All are economically repeatable.
- 2 IvanDoc Documentation
- 3 Technical documents in IvanDoc Documentation
- 4 See also
- 5 Notes and references
- 6 External links
Three main processes of IvanDoc System
First process: Scanning and data collection for the contents of documentation.
Firstly, being an auto-generator of technical documentation, IvanDoc System runs in the IBM i / AS400 operating system to scan all the objects of the business application to capture data from them. These object data are technical information about the architecture of the application software and are used by IvanDoc System to create and auto-generate various types of technical documents about the application software. Beside the objects, IvanDoc System can scan the source code of the application software to auto-generate and produce more types of technical documents.
The capability to cross-reference from one location of a technical document to a particular location of another technical document or vice versa, is now made possible with the use of HTML hyperlinks if the technical documents are written in HTML files or web pages.
IvanDoc System is a unique documentation generator that has been created to add this feature of cross-referencing vide HTML hyperlinks, into the technical documentation about any business application software running in the IBM i / AS400 operating system.
To provide meaningful cross-referencing among various types of technical documents, IvanDoc System has been engineered to insert HTML hyperlinks into the technical documents during their construction. These technical documents are actually static web pages, written by programs in IvanDoc System in HyperText Markup Language (HTML). However, at this point, these technical documents are not ready to be viewed vide web browsers as they are still residing in source physical files  in the IBM i / AS400 operating system.
Third process: FTP transfer of technical documents to browser-based operating system.
Thirdly, IvanDoc System facilitates the FTP transfer of these documents from the IBM i / AS400 operating system to any popular browser-based operating system where they can be assessed and viewed vide web browsers. Because the number of these documents or HTML files is usually huge and to ensure that not a single document is missed, IvanDoc System has the mechanism to keep track of which documents have been successfully transferred and which have not.
All are economically repeatable.
As all the three main processes of IvanDoc System are automated , they can be economically repeated to update  the technical documentation whenever it is out-dated by substantial changes which have been made to the application software.
|IvanDoc Documentation||cross-referencing technical documentation|
|automatically generated by||IvanDoc System|
|automatically written in||HTML|
|(1) can be viewed vide||major web browsers like Internet Explorer or Google Chrome in non-mobile PC operating systems in desktop or laptop computers.|
|(2) can be viewed vide||popular web browsers in Android operating system in smartphones or tablet computers, or Safari in iOS.|
|to be used by||IBM i/AS400 application developers like programmers, system analysts or designers.|
|to be used as||software analysis / change impact analysis tool for IBM i/AS400 applications, and for other purposes.|
|sample set||This sample set  was generated and produced as a final result of IvanDoc System's three main processes on an IBM i / AS400 business application and some of its source code. At that time, the application in a UAT environment had the following numbers of objects;
This sample of IvanDoc Documentation has 126,761 HTML files residing in various folders as shown in the table below;
This unique technical documentation, having been created in the IBM i / AS400 operating system and whose contents originate from the IBM i / AS400 application software, but whose technical documents are able to be viewed only in browser-based operating system, where cross-referencing among the various types of technical documents can be achieved with the help of HTML hyperlinks, is called “IvanDoc Documentation”.
Unlike technical documentation in the IBM i / AS400 operating system where IBM 'green-screens', spooled files, object data stored in physical files and SEU / PDM are used, IvanDoc Documentation provides the IBM i / AS400 software developers, in search of the knowledge of the architecture of the application software, with the new experience of navigating through the technical documentation in browser-based environment, thanks to the HTML hyperlinks.
Technical documents in IvanDoc Documentation
There are more than forty types of technical documents in IvanDoc Documentation. Each technical document of one type is linked to technical documents of other types by HTML hyperlinks. Each technical document is actually one HTML file and varies in size. Generally, the total number of technical documents or HTML files in IvanDoc Documentation depends on the size and complexity of the application software and the extent of the source code that has been scanned.
The various types of technical documents can be grouped into the following three categories based on the origin of their contents;
- Category (1) : Those whose contents originate from the object data only.
- Category (2) : Those whose contents originate from the source code only.
- Category (3) : Those whose contents originate from both the object data and the source code.
Notes and references
- (There are two phases of scanning. In the first phase, all the objects in the library list of the application software are scanned. The source code is scanned in the second phase.)
- (object data, unlike user data or business data, are information about the object's type, properties and so on, and are retrieved using certain CL commands like DSPPGMREF and DSPOBJD in the IBM i/ AS400)
- (scanning the source code is equivalent to reading the source code in source physical file)
- (types of technical documents produced from IvanDoc System's scanning source code - the HTML reproduction of CLP/CLLE source code)
- (types of technical documents produced from IvanDoc System's scanning source code - the HTML reproduction of RPGLE source code)
- (source physical files are used by IvanDoc System to store HTML source code)
- (The first and second processes are fully automated while the third process is not fully automated as it involves the establishment of FTP connection. For more information, the Operation Manual (to transfer HTML to PC after scanning) should be referred.)
- (update - it is recommended that the old set of technical documentation is to be replaced with or overriden by the new set which has just been generated and produced. Selecting a subset of documents from the new set to update the old set usually takes time and effort and more prone to human error.)
- (The main purpose is to serve as a software analysis tool, improving developers' productivity.)
- (It serves as training materials and software documentation tool for IBM i/AS400 application developers. It has the potential to be a version control tool.)
- (IvanDoc System was parameterised to generate the sample set for browsing in non-mobile PC operating systems in desktop or laptop computers. Browsing the sample set in a mobile operating system, may encounter long delay or Hang due to loading a relatively large HTML file. To reduce the sizes of HTML files, suitable for browsing in smartphones or tablet computers, will result in an increase in the number of HTML files, assuming that the total amount of contents in the documentation remains constant. For parameters controlling the sizes of HTML files to be generated, please refer to Operation Manual - To set up Control Parameters before Scanning.)
- Those numbers were provided by IvanDoc System at the bottom of this technical document.
- (Fields are not considered as objects but are object data from file objects and can be extracted using CL command DSPFFD.)
- (This folder is called IvanDoc Directory.)
- (spooled files)
- (object data, having been retrieved and stored in physical files, can be processed by programs just like user data or business data)
- (physical files)
- (SEU as a source-code editor)
- (sample and brief description of each type)
- (While IvanDoc System scans all the objects of the application software in the first phase, the selection of the source code for scanning in the second phase, is not determined by it. For the selection of the source code for scanning, please refer to Operation Manual from (Doc to read 41) to (Doc to read 53A) )
- Introduction to IvanDoc System
- IvanDoc Documentation
- Scanning of IvanDoc System
- Cross-referencing capability of IvanDoc Documentation
- Toggle between IBM i/AS400 and browser sessions
- Various types of technical documents in IvanDoc Documentation
|This programming-tool-related article is a stub. You can help Wikipedia by expanding it.|