Processing logic
The processing logic of Elements_with_New_Versions_Since_Date.prl is
as follows:
- When the Report Builder processes the interface specification, the report
procedure yields two parameters:
LOOKIN CCTIME
The mechanics of the LOOKIN parameter are described in Example 1: Adding a column to report output. When the report procedure receives CCTIME, it is a string of this form:
CCTIME = "time"
This parameter specifies the times that the cleartool find command uses.
- When the report procedure is invoked by the Report Viewer with a fully qualified command line, the procedure extracts the values from the CCTIME string and passes them to the chooser_time_to_cctime() subroutine (located in common.prl). This routine converts the string to the correct format (for passing to cleartool) and returns the corrected string.
- The report procedure opens a pipe from a cleartool find -print command, with the converted cctime value passed in as a created_since(<cctime>) string. The value created_since is a query_language(1) predicate, which is frequently used in conjunction with the find command.
- As the values from the cleartool find command are returned, the report procedure calls cleartool describe on the output to get the version-creation time. The routine calls the time_to_ticks() routine (in common.prl) to get the time equivalent in ticks.
- The report procedure gets the path and version ID from the cleartool find output, splitting it on the value of the $CLEARCASE_XN_SFX extended naming symbol for the host. Finally, the report procedure prints the information in the same order as defined in the interface specification.