Flag Utility screen
Related Topics
The Flag Utility screen displayed in the following figure allows you to compare two versions of a source program independent of the compiler used. You can also compare baseline and current source listing members for the creation of the flagged source listing members. This screen is accessed by entering option 6 on the Code Coverage Utilities menu.
When the Flag Utility is used for comparison purposes, it creates a new source listing member whose modified lines are tagged with an identifier. These members can be in separate source listings or in the same source listing file. An error message will be issued if a member is missing for any reason.
You can use the Flag Utility screen to provide the necessary input to create the control cards for the Flag Utility by accessing multiple Flag Utility screens and completing the required fields. You will be able to select multiple baseline members by completing a separate Flag Utility screen for each pair of baseline and current programs.
Flag Utility Screen
COMMAND ===>
Specify parameters:
Base DDIO dataset name ===>
Base listing number ===> (Required if program name blank)
Current DDIO dataset name ===>
Current listing number ===> (Required if program name blank)
Program name ===> (* = all)
Flagged DDIO dataset name ===>
User Identifier ===>
User Identifier start col ===> 73 (73 - 80)
Continue on error ===> YES (Yes/No)
Execution ===> RUN (Run/Simulate)
Execution mode ===> BATCH (Foreground/Batch)
Edit JCL ===> NO (Yes/No)
Press ENTER to process or enter END command to terminate
Input fields
The input fields are defined as follows:
Field | Description |
|---|---|
Base DDIO data set name | Specifies the ddname of the source listing file that contains the baseline members. If the current source listing file contains both the baseline and current members, this DD statement is not required. |
Base listing number | Specifies the listing number of the baseline members. This field can be left blank if the program name is supplied. If the program name is not supplied then this field is required. |
Current DDIO data set name | Specifies the ddname of the source listing file that contains the current members. |
Current listing number | Specifies the listing number of the current source listing member. This member is compared to the member specified in the Base listing number field. The flagged results are written to the data set specified in the Flagged DDIO data set name field. This field can be left blank if the program name is supplied. If the program name is not supplied then this field is required. |
Program name | Specifies the program name of the source listing member. Wildcard characters can be entered. This field is limited to program names whose length is 8 characters or less. If a program name is specified instead of base listing number and current listing number, the members most recently written to both source listing files with the specified program name are compared. |
Flagged DDIO data set name | Specifies the ddname of the source listing file for the tagged member. If the current source listing file is to be used for the tagged member, you should not specify this data set name. |
User Identifier | Specifies the user-defined identifier and its location. The first parameter is the ID (User ID name) and the second parameter is the starting column position (limited within columns 73-80). Both values must be enclosed in parentheses and separated by a comma. The length of this field is limited to 8 characters. Example: ID=(TOM,73). |
User Identifier start col | Specifies the beginning and ending columns used for the source comparison. Both values must be separated by a comma. The length of this field is limited to 5 characters. |
Continue on error | Specifies whether the FLAG command is to continue if recoverable errors are detected during execution. Select Y for YES or N for NO. |
Execution | Specifies the execution of the FLAG command. Select R for RUN or S for SIMULATE. When you enter RUN, the system creates a flagged source listing member and produces a detailed report. Choosing SIMULATE will produce a detail report without creating a new source listing member. |
Execution mode | This field displays the words Foreground or Batch depending on your selection. |
Edit JCL | Specifies whether you desire to edit the prepared JCL before submitting the job for execution. Select Y for YES or N for NO. |