AUDITO: Audit Outline Levels for STS Module Titles

Last updated 18 Nov 97

This program searches the module titles given and finds all levels of the outline that are missing. It then generates the missing entry with a blank title and places that line in the output allowing the user to later supply the title for the missing level. The output will then contain entries for all of the levels. Also, the output modules will be renumbered to be in sequence.

Program Invocation

The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.


@codap audito <opt> <ssss> <CI1(in-MT)> <CI2(out-MT)> <CI3(out-MP)>

opt:      (none currently supported)
ssss:     The study number 
CI1:      Input module title card images
CI2:      Output module title card images
CI3:      Output level pointer card images. The format of these card
          images is described below.

Output Level Pointer File

This is a unique file created by AUDITO. The purpose of this file is to allow other programs to produce a higher level summary outline by collapsing references to subsections into their broader areas. For each entry in an outline, there is a record which tells which module to use for each potentially desired level. This method assumes a maximum nested depth of six. For example:

1.
 1A.
  1A(1).
   1A(1)a.
    1A(1)a(1).
     1A(1)a(1)(a).

Consider the following example outline/module definition:

    0001  1.
    0002  1A.
    0003  1A(1).
    0004  1A(2).
    0005  1B.
    0006  2.

For each entry in the outline there is one record in the output file which contains six 4-digit numbers:

   000100010001000100010001
   000100020002000200020002
   000100020003000300030003
   000100020004000400040004
   000100050005000500050005
   000600060006000600060006

The last 4-digit number is the CODAP module number for the outline entry and will correspond to the line number within the file. For each entry the left-most 4-digit number represents the appropriate module number to use if the user requests a 'Level 1' summary. The second 4-digit number indicates the appropriate module number to use if the user requests a 'Level 2' summary. The default is a 'Level 6' summary which means all entries are used and no summarization takes place.

Back to document index