Utilities

Shareable Projects

Chapter 16: Complete Project

When Revolve loads a project it tries to resolve all system-wide relations. However, user intervention is occasionally required, especially in cases where direct name matching is not appropriate. These relations are needed to perform system-wide analysis tasks like tracing how a field impacts other fields throughout the project. With the functionality provided by the Complete Project window you can match up common files, executables, screens, etc. with appropriate files in your system or indicate that a resolution is unavailable. We recommend that you leverage the Complete Project features against your project to tie up the loose ends that may exist and to protect the integrity of your project analysis.

The Complete Project window is displayed by selecting the Complete... option under the Project menu. Possible problems are displayed as folder entries in the window. Expand the folders. Anything listed below the folder entry needs to be examined more closely. Specfically, a fix should be performed.

16.1 Fixing Problems

To fix problems in the project, select the problems or problem types you would like to fix and click the Fix... button. An appropriate Fix dialog will be displayed. When the parent (top line) of the Complete Project entry is selected and the Fix... button is clicked, a dialog will be displayed asking if all pertinent items should be included in the fix. If you choose No each problem will need to be repaired individually. If you choose Yes the Skip button is enabled and allows you to move down the list of entries, skipping those entries which should not be fixed.

16.1.1 Fixing Unused Load Modules

An Unused Load Module signifies a program which is not invoked by any other component in the project. Typically the problem occurs in four ways:

• The program does not truly belong to the project, since it is never used by any other component in the system. In this case, the program component should be deleted from the project (see "Deleting Components").
• The program is called directly by the user or by JCL which is not available. In this case, choose the Invoked externally option.
• The program creates a load module with a different name. In this case, choose the correct load modules name under the Associate with load module: option.
• The program is associated with a CICS transaction. In this case, choose the correct CICS transaction under the Associate with transaction: option or add the CICS PCT or CSD report.

16.1.2 Fixing Load Modules w/o Source Code

A Load Module w/o Source Code signifies a load module which is not associated with any source code. This problem occurs in three ways:

• The source code is not pertinent to the project. The load module could be an assembly routine, or third-party product for which analysis is not necessary or possible. In this case, choose the Source code is unavailable option.
• The source code has a different name than the load module. In this case, choose the correct load modules name under the Source File: option. You may type in the full name directly or type a match query and use the match button to populate the list of existing source code.
• The source code is missing from project. Click on the Add Src button to add the missing source code.

Note: By default, a program's load module name is determined by the PROGRAM-ID in the Identification Division. However, Revolve also allows load module names to be determined directly from the source code's file name. To enable this function, select Admin... from the Utilities/Options menus, click the Component Parameters button, and select the "Use Component Name" checkbox in the Component Parameters dialog (refer to "Component Parameters" in chapter 7 "Utilities").

16.1.3 Fixing Copybooks/Procs Not Found

A Copybook/Proc not found signifies that a copybook or proclib include file could not be found in the project. This problem occurs for three possible reasons:

• The PC file for the copybook is named differently than the copybook. In this case, click on the Copy Translation... button to translate from the copybook name to the correct file name.
• The copybook is not available or not pertinent to any analysis. In this case, choose the Import is not available option and click OK
• The copybook/proc is missing from project. Choose the Add copybook to project option and click OK. This will bring up the Project Add Component dialog box allowing you to add copybook components to the project. Perform a make to load the added copybook.

16.1.4 Fixing Screens without Source Code

A Screen without Source Code signifies that a screen used in the project is missing source code. This problem arises in three ways:

• The screen's source code is unavailable or not pertinent to the project. In this case, choose the Source code is unavailable option.
• The source code has a different name than the screen module. In this case, choose the correct load modules name under the Source File: option. You may type in the full name directly or type a match query and use the match button to populate the list of existing source code.
• The source code is missing from project. Click on the Add Src button to add the missing source code. Perform a make to load the new screen.

16.1.5 Fixing Unresolved PROGRAM External Files

A PROGRAM external file not associated with files signifies that a COBOL external file is not being properly associated with a physical data file. This problem occurs for three possible reasons:

• The COBOL program is not being invoked by the correct JCL. This could be because the JCL has not been loaded into the project, in which case the user should use the Project/Add function. Or it could be that the load module and program name do not match for this particular COBOL program, in which case the user should fix the relevant Load modules without source code problem.
• The relevant JCL DD is not available and not pertinent to analysis. In this case, the Associated Data File is not required for analysis option should be selected.
• he relevant JCL DD is not available, but the correct physical data file is known. In this case, choose the correct data file name under the Data File option. You may type in the full name directly or type a match query and use the match button to populate the list of existing data files.

16.1.6 Fixing Unresolved System Variables

An Unresolved System Variable signifies that a variable used to resolve a system-wide access (calling a program, sending to a screen, etc.) could not be populated with any values. To fix these problems associate the variable with the proper value. You may type in the full name directly or type a match query and use the match button to populate the list of existing system-wide items. If multiple values need to be entered for a particular variable use the Variable Data dialog, invoked by pressing the Variable Data... button from the button bar.

16.1.7 Fixing CICS Datasets Associations to Files

A CICS Dataset not associated with files signifies that a CICS dataset is not associated with a physical data file. This problem arises for three possible reasons:

• A CICS FCT table is available but has not been added to the project. Using the FCT table, Revolve can associate the CICS datasets with the proper physical data files. To add an FCT table to the project use Project/Add. Perform a Make to load the FCT.
• The related physical data file is not known and is not relevant to any analysis. In this case, choose the Associated Data File is not required for analysis option.
• The related physical data file is known. In this case, choose the correct data file name under the Data File option. You may type in the full name directly or type a match query and use the match button to populate the list of existing data files.

16.1.8 Fixing CICS Program Associations

A CICS program not associated with load module signifies that a CICS program can not be related to an existing load module in the system. This problem occurs for two possible reasons:

• The CICS program source code is not pertinent to the project. In this case, choose the Associated load module is not required for analysis option.
• The CICS program has a different name than the load module. In this case, choose the correct load module's name under the Load Module: option. You may type in the full name directly or type a match query and use the match button to populate the list of existing load module.

16.1.9 Fixing CICS Transaction Associations

A CICS transaction not associated with load module signifies that a CICS transaction can not be related to an existing load module in the system. This problem occurs for three possible reasons:

• A CICS PCT table or CSD report is available but has not been added to the project. Using the PCT table or CSD report, Revolve can associate the CICS transactions with the proper load modules. To add a PCT table to the project use Project/Add. Perform a make to load the new PCT.
• The CICS transaction's load module is not pertinent to the project or the CSD report. In this case, choose the Associated load module is not required for analysis option.
• The proper load module for the CICS transaction id is known. In this case, choose the correct load module's name under the Load Module option. You may type in the full name directly or type a match query and use the match button to populate the list of existing load modules.

16.1.10 Fixing Component with Errors

A Component with Errors signifies that a component was not properly loaded. Typically this means a component was added with the wrong type (e.g. Assembler file added as COBOL), or that the parser options were set incorrectly. Use the Project/Delete to remove improperly added components.

Note: The Parsing Problems script, located in the Scripts tool, can be useful to identify and locate components with errors.

16.1.11 Fixing IMS Transaction Associations

An IMS transaction not associated with load module signifies that an IMS transaction can not be related to an existing load module in the system. This problem occurs for three possible reasons:

• An IMS Stage 1 Gen file is available but has not been added to the project. To add an IMS Gen file, select the Add option from the Project menu or Project Manager. Perform a make to load the Gen file.
• The IMS transaction's load module is not pertinent to project. In this case, choose the Associated load module is not required for analysis option.
• The proper load module for the IMS transaction has a different name. In this case, choose the correct load module's name under the Load Module option. You may type in the full name directly or type a match query and use the match button to populate the list of existing load modules.

16.1.12 Fixing IMS Programs to PSB Associations

An IMS program not associated with PSB signifies that an IMS program can not be associated with a PSB. This problem occurs for three possible reasons:

• For IMS batch programs, the IMS program is not getting invoked properly by a JCL. This could be because the JCL has not been loaded in the project, in which case the user should use the Project/Add function. It could be that the load module and program name do not match for this particular COBOL program, in which case the user should fix the relevant Load modules without source code problem.
• The proper PSB is not available or not needed for analysis. In this case, choose the Associated IMS PSB is not required for analysis option.
• For IMS on-line programs, the proper PSB needs to be associated. In this case, choose the correct PSB's name under the IMS PSB option. You may type in the full name directly or type a match query and use the match button to populate the list of existing PSBs.

16.1.13 Fixing IMS DBD Associations to Files

An IMS DBD not associated with files signifies that an IMS DBD can not be associated with a physical data file. This problem occurs for four possible reasons:

• IMS is using dynamically allocated DBD's through the DFSMDA macro. In this case, the DFSMDA components should be added to the project by selecting Add from the Project menu or from the Project Manager. Perform a make to load the DFSMDA macros.
• For IMS batch programs, the IMS program is not getting invoked properly by a JCL. This could be because the JCL has not been loaded in the project. In this case the user should use the Project/Add function. Or it could be that the load module and program name do not match for this particular COBOL program. In this case the user should fix the relevant Load modules without source code problem.
• The proper physical data file is not needed for analysis. In this case, choose the Associated Data File is not required for analysis option.
• For some IMS on-line programs, the proper DD is referenced in the DFSMVRC0 step. If the JCL containing this step is available use the Project/Add function to add it to the project. Perform a Make to load the new JCL.
• For IMS on-line programs, the proper data file needs to be associated. In this case, choose the correct data file's name under the Data File option. You may type in the full name directly or type a match query and use the match button to populate the list of existing data files.

16.1.14 Fixing IMS PSBs Not Used

An IMS PSB Not Used signifies that there are IMS PSBs that are not associated with COBOL programs. To remedy this problem:

• Associate the IMS PSB with a COBOL Program by selecting the Program indicator and use the Match edit box to locate the appropriate COBOL program. Select the correct program from the list and click the OK button.
• If the IMS PSB is not needed for analysis it can be tagged as unneeded by selecting the Associated Program is not required for analysis indicator.

16.1.15 Fixing IMS PSBs Without Source Code

IMS PSBs without source code are caused when the project contains IMS PSBs that are not associated with any source code. This problem can occur in three ways:

• The source code is not pertinent to the project. In this case choose the Source code is unavailable option.
• The source code has a different name than the IMS PSB. In this case, select the Source File indicator and choose the correct item's name from the Source File list. You may type in the full name directly or type a match query and use the match button to populate the list of existing source code.
• The source code is missing from the project. Click on the AddSrc button to add the missing source code.

16.1.16 Fixing IMS DBDs Not Used

IMS DBDs not used signals that the project contains IMS DBDs that are not referenced with IMS PSBs. To remedy this problem:

• Associate the IMS DBD with an IMS PSB by selecting the Program indicator and use the Match edit box to locate the appropriate program. Select the correct program from the list and click the OK button.
• If the IMS DBD is not needed for analysis it can be tagged as unneeded by selecting the Associated program is not required for analysis indicator.

16.1.17 Fixing IMS DBDs Without Source Code

IMS DBDs without source code alerts the user that the project contains IMS DBDs that are not currently associated with any source code. This problem can occur in three ways:

• The source code is not pertinent to the project. In this case choose the Source code is unavailable option.
• The source code has a different name than the IMS DBD. In this case, select the Source File indicator and choose the correct item's name from the Source File list. You may type in the full name directly or type a match query and use the match button to populate the list of existing source code.
• The source code is missing from the project. Click on the AddSrc button to add the missing source code.

16.1.18 Fixing IMS DBDs Not Associated With Files

IMS DBDs not associated with files signifies that the project contains IMS databases which are not associated with physical files. This problem occurs for three possible reasons:

• A JCL job is available but has not been added to the project. Using the JCL job, Revolve can associate the IMS DBD with the proper physical data files. To add a JCL job to the project, use Project/Add. Perform a Make to load the JCL.
• The related physical data file is not known and is not relevant to any analysis. In this case, choose the Associated Data File is not required for analysis option.
• The related physical data file is known. In this case, choose the correct data file name under the Data File option. You may type in the full name directly or type a match query and use the match button to populate the list of existing data files.

16.1.19 Fixing Unused Copybooks

Unused Copybooks alerts the user that copybooks have been added to the project but are not referenced in any of the programs. To remedy this problem:

• Associate the copybook with a program by selecting the Program indicator and use the Match edit box to locate the appropriate program in the list box. Select the correct program from the list and click the OK button.
• If the copybook is not needed for analysis it can be tagged as unneeded by selecting the Associated program is not required for analysis indicator.

16.1.20 Fixing IMS MFS Messages

IMS MFS Message not invoking an IMS transaction signifies IMS MFS Message that could not call or find a transaction. This problem can be remedied by associating the message with an IMS transaction.

16.2 Subprojects

The Complete Project process can be performed on a defined subproject. Click the Subprojects... button and select the subproject that should be completed from the Subprojects dialog.

See also Subprojects in Using Revolve for more information.

16.3 Review

The Review... dialog box, displayed by pressing the Review...button , provides the user with a listing of all system-generated and user-generated resolutions to system-wide problems.

The columns are as follows:

• Active: Whether the relation is currently in use in the project.
• Element: Type and name of source object.
• Relation: Type of system-wide relation.
• Value: Value of relation.

If a mistake was made during a Complete Project fix, the user may delete the incorrect relation by selecting on the relation and clicking on theDelete Selected button. When finished viewing the Review List, clickOK to return to the Complete Project dialog box.

16.4 Variable Data

In COBOL and PL/I, statements can invoke a load module or screen, or access a data file through a variable. To handle this case, Revolve creates multiple invoke and access relations, one for each value of the variable. Initially these values are computed by Revolve during the load. The Variable Data... button displays this list of values and allows the user to modify these values so that the proper load modules are invoked and the proper data files are accessed.

• Variable Name Name of the variable.

• Program Program containing the variable.
• Use Specifies if the variable is used to invoke a load module or screen, or access a data file.
• Value Value of the variable.
• Edit Edits user value for variable (does not edit system generated values).
• Add Adds user value to variable (overrides any system generated values).
• Delete Removes user value from variable (does not remove system generated values).
• Done Closes Variable List.

By adding values to a variable with the Add button the user can override the system-defined values (and any improper accesses and invokes). Once a new value has been added to the variable, any system-generated values are ignored and thus removed from the list. The user may further customize the list of user-defined values with the Edit and Delete buttons. To restore the list of system-generated values for a particular variable, all user-defined values for that variable need to be deleted.

16.5 Process Schedules

The Process Schedules dialog box, displayed by selecting the Process Schedules... button , is used to create, modify, and delete scheduling information in Revolve. Schedules are used to emulate JCL, replace missing JCL, or create high level schedulers in Revolve. You define schedules by specifying the order in which components in the project's source code are executed. This information is then used in the System view to show the correct execution relations for job/program/transaction execution.

To create a new schedule,

1. Click the Add Schedule button .
2. Enter an alphanumeric name.
3. Click Ok.

The new schedule appears in the Process Schedules window.

To add elements to the new schedule:

1. Select the new schedule by clicking on it with the mouse.
2. Click the Add Process button .

3. In the Find dialog, specify item types by checking the appropriate checkboxes with the mouse.
4. Select an item from the scroll-able list that should be the first component in the process.
5. Click OK.
6. Double click the new schedule in the Process Schedules window.

The process that was added is contained in the folder for the new schedule. Processes are organized in descending order from last to first. So, the process that appears directly beneath the parent or top folder is the last step in the schedule. Likewise, the entry at the bottom of the list is the first step or process in the schedule.

If you want to add a new process to the list, select the line that you want the new process to precede and repeat steps 2-6 above. The new process will be inserted beneath the selected one in the Process Shedules window.

The System view will graphically depict this information by ordering the displayed components according to the process definition.

To delete a schedule select the undesired schedule in the information window and click the Delete Schedule button . To delete a process select the undesired item and press the Delete Process button .

Note: Schedules are stored as .SCH files and can be manually entered into a project via the Add Components dialog following the process described in Adding Components. Remember, after the new schedule has been added to the project, a Make should be performed to bring the project up to date.

16.6 Import Translations

The Import Translations button invokes the Import Translations dialog. If you have a copybook that has invalid DOS characters, this dialog is helpful for translations of copybook names. This option is also available in the Administrator Options dialog.

See also For details refer to Import Translations in Utilities.

16.7 Execution Indirection

Through the Execution Indirection window, invoked by the Execution Indirection button , a user can setup Revolve to handle low-level routines which perform invocation or data access based on passed parameters. For example, Wang COBOL programs commonly use an assembly routine LINK to call other programs based on the first parameter of the call statement.

CALL LINK USING 'PROGNAME',...

In order for Revolve to recognize this statement as calling program PROGNAME, one must use the Execution Indirection window.

The following is a brief summary of functionality available on the Execution Indirection button bar:

• The Add Executable... button prompts for the name of the executable and adds it to the project.
• The Delete Parameter button deletes the selected parameter indirection definition.
• The Add Parameter... button allows the user to set up an indirection through a parameter.

16.7.1 Adding Indirection

To add an indirection, choose the desired load module (or create a new one with the Add Executable button) and click on the Add Parameter... button .The Add Parameters dialog will appear and will prompt you for more information on the indirection.

The Type of Indirection pull-down listbox specifies what type of object is being invoked or accessed and allows you to change it to one of the types described below. Parameter # specifies which parameter contains the name of the object being invoked or accessed. Finally, the Start and End fields specify the starting and ending character positions for the object's name. If both start and end contain 0, the whole parameter is used. The Param Offset field adjusts the offsets for IMS PSB's that are passed through entry point calling. The possible types are described below.

• CICS dataset Accessing a CICS dataset
• CICS program Invoking a CICS program
• CICS trans Invoking a CICS transaction
• entry Invoking a load module (e.g. Calling another program)
• file Accessing a datafile.
• IMS database Accessing an IMS database.
• IMS trans Invoking an IMS transaction
• map Invoking a screen/map
• schedule Invoking a user-created schedule (see Process Schedules)

Utilities

Shareable Projects