Code Manual for CONTAIN 2.0 - Federation of American Scientists

● ensures that modifications will promulgate in the correct order,
● maintains the completeness of a set of modifications,
● maintains the historical integrity of the code, and
● provides a controlled means for reversing modifications, allowing a clean return to a
previous well-defined baseline.
To simplify the use of UPDATE emulators, CONTAIN developers are restricted to the use of a
limited subset of Cray’s UPDATE features. These features include
*deck to introduce a deck
*comdeck to introduce a COMMON DECK
*i to insert
*d to delete or replace
*compile to specify compile or source data set
*/ to comment
*purgedk to remove a deck.
In addition to the above restriction, blank lines are not allowed in the update files.
With the ongoing evolution of computing platforms, the CONTAIN code must be adaptable if it is
to keep pace with the changing environment. Following CONTAIN 1.2,CMP[Tho91] will be used
for creating updates. CMP is similar to UPDATE and has demonstrated compatibility in the
workstation environment. Under the new environment, it will be possible to make changes to
CONTAIN using a more direct approach than before, while still retaining the level of protection
offered by UPDATE. In this approach an old and new copy of the code will be kept in separate
directories by each of the various developers and a “differences” program provided as part of the
CMP tools will be used to generate code updates.
CMP consists of four major functions to maintain computer programs and other data sets. The frost
function is an UPDATE processor with system independent libraries that allow corrections and retain
a correction history. Program libraries can be transported between systems without loss of
information. The second function is a sorting processor that alphabetically sorts all subroutines,
fimctions, and other program units allowed under FORTRAN 77. Another option allows for sorting
of decks and comdecks in a program library. The third function is a differences and correction set
generator that operates by finding differences between two files. An update correction set is
produced to modi~ an update library. The fourth function is a collection of text file copying
utilities. A complete description of the CMP utility is given in ReferenceTho91.
An important part of CONTAIN configuration control is the concept of update freezing, introduced
in Section D.2.3. Should a need for modifying a frozen update be discovered during internal beta
testing, the modification would be implemented with a follow-on correction update. The follow-on
O D-n 6/30/97