Using the NonStop Setup Tool in CA Gen › Rebuild a NonStop Application

Rebuild a NonStop Application

Application generated using CA Gen can change through time. If a change involves only one piece of code or source member, then you do not need to rebuild the entire application. This also applies in cases where temporary fixes are applied to generated code on the NonStop host.

The Setup Tool can rebuild an application based on dependencies like the UNIX make utility. This means if source code has a newer timestamp than its corresponding object (or it does not exist), then a compilation event is triggered. Likewise, if object code has a newer timestamp than the executable they created (or it does not exist), then a link event is triggered. The same applies to a remote file and its source after it is split.

Let us assume that a temporary fix was applied to certain source members on NonStop. To rebuild your application servers, recompile the affected source members by selecting one or more remote files in the Install IP screen and pressing the F4 function key to reinstall your changes. If you are not sure which remote file contains the affected source members, select all the load module remote files. Even though you selected all load modules, the Setup Tool compiles only those source members that are affected by the fix you just applied. Any source member not affected by the fix will show a status of RETAINED, which means that the Setup Tool retained their original status. Use the Force installed IPs to Rebuild from Step field on the IP Install screen to override the dependency logic.

RETAINED Status

The RETAINED status assigned to any source member indicates that the source member was not rebuilt. The following reasons explain why source members can display a RETAINED status during installation:

• Common Action Blocks (CABs) are used when an application contains common code used by different load modules. The source member that implements the CAB needs to be compiled once; it displays a status of COMPILE at the end of the COMPILE stage. However, any reference to the CAB from other load modules will show as RETAINED.
• If there was a problem during the generation or packaging of the remote files on the CA Gen development workstation, some of the source members show a RETAINED status. This generally occurs during a first attempt to install an application on NonStop. Review the way you are packaging the load modules and the generation process. Ensure that your application does not contain CABs.

Sentinel Line

When a remote file is split, the Setup Tool appends a comment line at the end of each one of the extracted source members. This comment line is called Sentinel Line and it contains information unique about each source member. The Sentinel Line is used as part of the dependency rule during the compilation of the source member. Any modifications to this line may cause unexpected results during any subsequent builds. If you need to manually modify the code, you can do so as long as the Sentinel Line is not modified, and remains the last line of the code.