Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to...

33
1 Compuware Test Drive ISPW Change a PLI program Revised: 7/17/2020 This tutorial will review how to make changes to a PLI program in ISPW. From sign out to changing code to generating and promotion.

Transcript of Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to...

Page 1: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

1

Compuware Test Drive

ISPW Change a PLI program Revised: 7/17/2020

This tutorial will review how to make changes to a PLI program in ISPW. From sign out to changing code to generating and promotion.

Page 2: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

2

Contents

Getting Started with SCM - ISPW ..................................................................................................... 3

Code Changes ................................................................................................................................... 8

Generate (AKA Compile) ................................................................................................................ 17

Promotion ...................................................................................................................................... 24

NEXT STEPS .................................................................................................................................... 33

Page 3: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

3

Getting Started with SCM - ISPW

The goal of this Test Drive is to make a change to a PLI program and promote it to production using ISPW. Compuware ISPW enables developers to quickly and safely build, test and deploy mainframe their code.

This test drive will take you through the following activities:

• Creating an Assignment

• Code changes

• Use Topaz Editor

• Generating/compiling

• Promotion to Test and Production runtime environments

Instructions:

• This guide contains many screenshots to provide a visual reference

• Every action you must take is in BOLD

• Please note each place that you must enter your own specific ID or number

• You must complete each step before proceeding to the next to successfully follow the guide

NOTE: if you wish to rerun this Test Drive Script, simply pick the same element if you ended successfully and start over. If you did not end successfully pick another PLI program (CLPLS02, 03,04, etc.) to use and start the script over. Any other errors will require a call to ISPW support.

Page 4: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

4

The Compuware Test Drive Experience requires that users complete the Building Your Environment

http://resources.compuware.com/hubfs/Test%20Drive/Building_Environment_with_Host_and_JES_Explorers_TW_Test_Drive.pdf

exercise before starting any tutorial script. If, at any point during your experience, your host connection times out, you may need to log back into the Test Drive host connection.

To get started in the Topaz Workbench:

1. Open the Host Explorer perspective

2. Click on the arrow next to Hosts

3. Right-click on Test Drive and select Login

4. Logon on with the user credentials that were provided to you for with the Test Drive and click OK

5. Select ISPW from the Compuware menu

Page 5: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

5

Click the ISPW Repository Explorer view

Page 6: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

6

During this Test Drive you will encounter terms specific to ISPW. Here is a glossary for your convenience.

Term Description

Application Business Area

Stream Development Life-Cycle used by one or more Applications

Life-Cycle Transitional Code States (DEV, QA, PROD) in the Development Life-Cycle

Level Instance of a Code State (DEV, QA, PROD)

Component SCM managed object such as a Cobol source member.

Component Version An immutable version of a Component.

Task An instance of a unit of work. For example, a change to a Component.

Part A generated object such as a load module, or a Listing or a DBRM

Warehouse Storage location for inactive historical or overlaid Component Versions (source and parts).

Assignment Container A package of one or more, usually related, Tasks. A development container that is used to organize and manage development work.

Release Container A package of Tasks from one or more Assignment Containers. An operational container that is used to organize and manage operational releases.

Set Container A package of Tasks at an instance in time. A special ISPW container that is used internally to organize and manage work requests.

Add Task Make a statement of intent, often because of some impact analysis.

Checkout Task Copy source to development area

Edit Task Make a change to the source in the development area.

Generate Task Execute Compile and Link processes.

Promote Task Move Task forward to the next Level in the Life-Cycle.

Regress Task Move Task backwards to the previous Level in the Life-Cycle.

Delete Task Remove a Task from the development area

Fallback Task Restore previous version of Task.

Deploy Task Implement Task in one or more Run Time environments.

Page 7: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

7

Substitute your values in the screenshots

In this Test Drive the screen shots provided have used specific values that may differ from your assigned values. These were provided in your email notice.

While taking the test drive, you must substitute your assigned values!

Variable Your Assigned Values

Application Txxx*

Assignment Prefix Txxx*

* For the value of xxx, substitute the last three digits of your test drive username.

Page 8: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

8

Code Changes

Your development task in this Test Drive is to change a PLI program using Topaz editor, then generate and promote it through the Application Life-Cycle to Production.

First, you will find and add a PLI program into an ISPW Assignment from which you can perform all this work.

• Change the Stream to CWEZ

• Change the Application to your assigned application value (Txxx, where xxx is your unique number)

• Set the Level to “PRD” and ensure the Level option is set to “Selected level only” or “All found in level and above” both settings will return the same results since there is nothing above PRD.

• Filter the view even further by setting the Type to PLI, this will allow you to focus only on the PLI program components available in your stream | application at the PRD level. Click Apply (circled).

Page 9: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

9

The ISPW Repository View lists the PLI Components for your application.

Scroll through the list and find SLOGREPT at level PRD. Right-click on it and click Add to Assignment with Checkout.

Page 10: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

10

From the Add Task dialog box, select NEW to the right of Assignment. This will allow you to create a new Assignment Container to put your PLI program into. Type a description and click OK.

A message will be displayed providing you with your new Assignment name. Click OK.

Your new Assignment has been created and is ready to have Tasks added to it. An Assignment Container is the only Container Type in ISPW that Tasks can be added to. The Assignment Container is where a developer will spend much of their time.

Page 11: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

11

Your new Assignment number will appear in the Assignment field. Click OK.

A message will be displayed to inform you that the task has been added to your Assignment. Click OK.

Page 12: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

12

Your Assignment has been created and you should now have a PLI program in it. The Assignment Task List view will open and the Task that was added will be listed. Every operation that needs to be performed on this Task and other Components which are impacted by changing this Task (edit, impact analysis, compile, promote, deployment etc..) can be performed from this Assignment or other Assignments.

To see the ISPW Life-Cycle path structure that was constructed for the Application, click once on the Task and then click on the View Life-Cycle icon.

Note that the PLI program in the Assignment is checked out and sitting in the DEV1 level. The Checkout Date/Time and User ID is reflected in the Task information. At checkout, a destination level for the checkout was chosen – DEV1.

A picture of the Life-Cycle is presented. You will notice the levels containing the Versions of the highlighted PLI program are colored indicating the existence of a version of that Component at

those levels.

Page 13: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

13

From this picture it is very easy to visually see where Versions exist. By choosing the DEV1 Level, you have defined the Path to Production → DEV1-QA1-STG-PRD. Other versions of these Components may also exist at other levels and may be passing thru the other three paths – FIX, DEV2 or DEV3.

Four paths were created for the application – one for emergencies starting at level FIX and three for development starting at DEV1, DEV2 and DEV3. The application level structure is customizable when defining the applications to ISPW. Any number of paths can be defined with a minimum of three Levels.

Now that you have a Version of a PLI program the next step would be to make changes to it. To do this either right-click on SLOGREPT and click Edit or simply double-click on it.

Page 14: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

14

Change the source using Topaz Editor.

First either select Find/Replace from the Edit menu or scroll down through the program and find CLOSE on your own or click Ctrl F. Type close in the Find field and click on Find.

Close the Find and Replace dialog by Clicking on the X in the upper right-hand corner.

Page 15: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

15

Move your insert cursor to the comment box and make a change in the comments.

You are now done with your edit. Once you have made your changes, close the Topaz Edit view. Click Yes to save the changes.

Page 16: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

16

Note the Operation, Date/Time and User ID fields have been updated to reflect the change in the Task status.

Page 17: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

17

Generate (AKA Compile)

Page 18: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

18

The PLI program will be generated/compiled, and your Assignment Task List will be updated to reflect the new status.

• The Operation will be Generate

• You will have the opportunity to change your compile options

• The User ID, Date/Time will be updated

• The Message will be updated to reflect the successful completion of the generate

Now it is time to compile/generate the program, so we can do our testing. To do this, right-click on SLOGREPT and click Generate with Parms.

A screen will appear and give you the opportunity to change some of your compile options. This screen is customizable for your site. Any options you may need at compile and link time can be added to this screen. Make sure a version for the compiler is selected.

Page 19: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

19

ISPW retains the generate options for each program at each level, so you do not need to change the generate options every time you generate.

Click OK to continue.

The status column will display a message indicating that the Task is being generated. The screen will refresh automatically when the generate is done. At that time, the Task will be updated with the date and time of the generate, the user who performed the generate and the operation will reflect a generate has occurred.

Page 20: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

20

After the generate finishes you can browse the Generate listing at any time.

To do this, right-click on the Task and click “View Generate Listing.”

You will get this informational message if there are characters in your listing that can’t be converted for display purposes. If you do get it this is not a problem and you can click OK.

Page 21: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

21

Scroll up and down, notice that everything is available that you normally see in a compile listing.

Close the Listing display when you are finished.

Page 22: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

22

You can also view the output of the generate job.

Right-click on the task and click “View Generate Job Output.”

This displays the output of the job that did the Generate.

Close the Job Output display when you are finished.

Page 23: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

23

ISPW collects each of the parts created as part of the generate (Load, Listing, DBRM, etc.) and registers them against the source.

To view the generated parts, right-click on the Task, place your cursor on “View” and click on “Parts.”

The generate of this program created an Object, Listing, Load, and a DDIO (part DMEM). The types of parts created can be unique by application and type of component as well as the values of the generate parms. Close the ISPW parts view.

Page 24: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

24

Promotion

At this point you have

• Edited a PLI program

• Used the Topaz Editor to help you make your changes

• Generated your program with the option to change the generate parameters

Now you are ready to promote your changes to the QA1 level. To promote the Task to the QA1 level, right-click on the Task and click Promote.

Page 25: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

25

This action will create a Set Container. Sets are a special category of container that are used to conduct operations such as promotion and deploy. They are temporary and created by ISPW as needed for the work. This allows you to promote subsets of Tasks within an Assignment container without the need to act on all the Tasks at once.

Once you click Promote the selected Task(s) are placed in a SET container for the promotion.

The ISPW Set processor will:

• Perform the promotion of the source to QA1

• Cleanup the DEV1 level (source and parts if applicable)

• Perform generates, in order, of all the Task(s) in the SET which require a generation

Click OK.

Page 26: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

26

In the screenshot below, you can see the promote operation has completed – the Task has been promoted to QA1 (see the Level value and the Operation in the Task List as well as the highlighted Level in the picture).

Note the Operation column shows Generate as the last operation. The SET processor performed a promotion and then a generation as ISPW recognized a generate was required for PLI types at the QA1 level based on the configuration of this application. This can be configured by the ISPW administrator.

Page 27: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

27

Let us assume all the testing at the QA1 level has been successfully completed and you are ready to promote to the STG level. Select the Task as before, right-click and click Promote.

In the screenshot below, you can see the promote operation has completed – the Task has been promoted to STG (see the Level value and the Operation in the Task List as well as the highlighted Level in the picture).

Note the Operation column shows Promote as the last operation. The SET processor performed a promotion. This can be configured by the ISPW administrator.

A Set container is created. The selected Task(s) are placed in a SET container for the promotion. The ISPW Set processor will:

• Perform the promotions of all the parts to STG

• Cleanup the QA1 level (source and parts if applicable)

Page 28: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

28

Assuming all the testing at the STG level has been successfully completed, you are now ready to promote the Tasks to the PRD level.

Select the Task as before, right-click on it and select Promote.

In this screenshot, as the Task(s) in the SET are being processed, you can see:

• The Task will be selected for a Promote

• ISPW will start a SET processor for this SET

• The PLI program, and its parts will be promoted

You can monitor the progress by clicking the refresh button.

Page 29: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

29

Note: ISPW uses your installation’s security (RACF/Top Secret/ACF2) to manage process security (granular control of permissions by user and function). Process security defines who can perform which commands at which levels in the Life-Cycle.

While a Developer can perhaps request the Promote operation when promoting to the STG and QA1 levels, perhaps a Change Coordinator role is responsible for requesting the Promotion to PRD.

One or more approvals can be put in place for each application/level promotion, including but not limited to Application Manager, QA Manager, Impact, DBA, JOB Scheduling, Peer, or VP roles.

A Set container will be created. The selected Task(s) are being placed in a SET container for the promotion. The ISPW Set processor will:

• Perform the promotions of all the parts to the PRD Level

• Cleanup the STG level source and parts as applicable

The application has been configured to require an approval for the Promotion to PRD. Click OK.

Page 30: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

30

Below the STATUS shows the Tasks are locked in a SET for a Promote process but the SET needs approval before the promote can proceed.

The Approval can be performed from:

• Topaz/ISPW

• TSO/ISPW in the ISPF interface

• Web interface (including mobile browser)

For this Test Drive you will do the approval from Topaz/ISPW. To perform the approval, click on the task, then right-click on the STG box in the Life-Cycle diagram. Click “Approve.” ISPW will now perform the promotion of the Tasks collected in the SET to the PRD Level.

You can see in the updated screen below that:

Page 31: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

31

• SET processing has completed

• The PLI program has been processed for a Promotion and is now at the PRD level

The Promotion to the PRD level has completed. The source and parts for the PLI program were moved to the PRD level Life-Cycle libraries and the STG level libraries were cleaned up as appropriate.

Notice the Operation column shows Implement as the last operation. ISPW performed any tasks that were configured for deploy and activation.

An example of a Deploy Implementation activity is the copy of the executable load module into a CICS or IMS runtime library.

Examples of an activation activity would be a DB2 Plan or Package Bind or a CICS New copy.

Page 32: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

32

As a Developer you are now finished with your Assignment, so it can be closed. Assignments are closed manually and are usually closed to unclutter the ISPW Container List View. To Close your Assignment, right-click on your Assignment and click “Close.” A Close confirmation panel is presented.

Click OK to complete the Close.

For audit purposes, Closed Assignments, Sets and Releases are never deleted from ISPW. They are just filtered out of the standard day-to-day filtering.

Once an Assignment, Set or Release is closed it is removed from the standard filtered list, but it is still part of ISPW history and can be viewed at any time.

Page 33: Compuware Test Drive ISPW Change a PLI program Drive... · connection times out, you may need to log back into the Test Drive host connection. To get started in the Topaz Workbench:

The Mainframe Software Partner for the Next 50 Years

33

You are done – your job has been to change a PLI program. As a part of this exercise, you have been able to use Compuware Topaz Workbench and ISPW to execute a workflow:

• Created an Assignment

• Added and checked out a PLI program

• Changed it using Topaz Edit

• Compiled/Generated the program

• Viewed the listing from the Generate

• Viewed the generate output from JES

• Viewed the Parts created as part of the Generate

• Promoted the Task from DEV1 to QA1 with a generate of the program

• Promoted the Task from QA1 to STG

• Promoted the Task from STG to PRD

• Performed an approval

• Closed your Assignment to complete the change cycle

Congratulations! This completes the ISPW tutorial for Compuware Test Drive.

NEXT STEPS

Click on the link below to return to the Compuware Test Drive main page and choose your next road trip!

COMPUWARE TEST DRIVE