Endevor Tool - Workshop Objectives


Change Packages Workshop

Workshop Objectives

Upon completion of this workshop, you will be able to:

   Create a Change Package
   Cast a Change Package
   Execute a Change Package


Workshop Format

Each workshop in this class has been designed using step tables to help you navigate through Endevor.  Each step table will contain “What You Do” and “Comments/Prompts”.  The tasks to be performed can be found in the “What You Do” column.  The “Comments/Prompts” column will contain information or an explanation about the task you just performed.

You will also find practice questions embedded throughout the workshop for you to answer.  These questions are used to help you learn and reinforce the task you have just performed.  If you get stuck or would like to verify your answers, the answers can be found in Appendix B.


Endevor Workshop Structure

In the last workshop, you RETRIEVEd FINARP01 and HEADER01 with no signout and changed the names to FINARPxx and HEADERxx.  You then made changes to both and ADDed them back into Endevor.  When you ADDed the COBOL program, you also performed a GENERATE, because you did not specify BY PASS GEN.  The following diagrams depicts the current situation.

System             = FINANCE
Subsystem       = ACCTREC
Type                 = COBOL, COPYBOOK


At this training account, the approval process has been set up to approve any inventory that will be GENERATEd within, DELETEd from or MOVEd into the Quality Assurance Stage.  This is the stage for customer acceptance.  You review the current situation and come the conclusion that you will need to build a Change Package to MOVE your inventory from Unit Test to Quality Assurance.

In this workshop, you are going to CREATE, CAST, and EXECUTE a package to MOVE FINARPxx and HEADERxx.  Your instructor will act as the approver for the REVIEW step.

Now that you know what you need to do, let’s get started!

Access Endevor

Your instructor will provide detailed instructions.  Basically, you need to:

-       Logon to TSO ISPF

-       Select A to get your account panel

-       Select the appropriate Endevor training system

You will get the Endevor/MVS Environment Selection panel.


This is the first panel that you see each time you invoke Endevor.  All environments for which you are authorized access will be displayed on this panel.

What You Do
Comments/Prompts
Select 1 (DEMOTEST) and press ENTER
You should now be at the Primary Options Menu.  This menu will contain only those selections for which you are authorized.



What You Do
Comments/Prompts
Select 5 (Package) and press ENTER
This will display the Package Options Menu.


What You Do
Comments/Prompts
Select 2 (Create/Modify)
You want to create a change package.
Enter a Package ID. Use your TSO ID - TETRN##
In order to create a package, you will need a Package ID.  This field is used to identify the package.

Press ENTER
The next screen will be the Create/Modify Package panel.




What You Do
Comments/Prompts
Select B (Build Package Action)
You are in the process of building your package to perform a MOVE of FINARPxx and HEADERxx.
Enter a description of your package
Describe the package.
Enter a type of STANDARD
You are creating a change package under normal circumstances, not an emergency.
Enter “Y” for Sharable Package
You want to allow additional users the ability to add to the package.
Press ENTER
This will display the SCL Generation Panel.


What You Do
Comments/Prompts
Select 5 (Move Action)
You are in the process of creating the MOVE SCL for your package.
Press ENTER
This will display the MOVE panel.

Since you have already learned the MOVE panel from the Inventory Maintenance module, you should be familiar with the panel and its fields.  You want to MOVE both FINARPxx and HEADERxx to the next stage in the migration path.


What You Do
Comments/Prompts
Enter the following “FROM Endevor” information:
  Environment:  DEMOTEST
  CCID:             TETRNXX
  System:           FINANCE
  Subsystem:       ACCTREC
  Element:         HEADERxx
  Type:              COPYBOOK
  Stage:              T

You are in the process of creating the MOVE SCL for your package.  Remember that Endevor already knows the “TO Endevor” information from the pre-defined map.
Enter a comment
Fill in a comment that pertains to the action.
Place “O” on the command line and press ENTER
This lets Endevor know that a MOVE is to be performed.  This will write the MOVE SCL for HEADERxx.
Enter the following “FROM Endevor” information:
  Environment:   DEMOTEST
  CCID:              TETRNXX
  System:            FINANCE
  Subsystem:        ACCTREC
  Element:          FINARPxx
  Type:               COBOL
  Stage:              T
After the MOVE SCL is written for HEADERxx, enter the MOVE information for FINARPxx.  This will write the SCL to move the COBOL program.
Enter a comment
Fill in a comment that pertains to the action.
Place an “O” on the command line and press ENTER
This lets Endevor know that a MOVE is to be performed.  This will write the MOVE SCL for FINARPxx. 
Press PF3

This will return you to the SCL Generation panel.  Check the upper right hand corner for a message stating that your 2 requests were built successfully.



What You Do
Comments/Prompts
Press PF3 twice
This will take you back to the Package Foreground Options Menu. 

Select 1 (Display) and press ENTER
You want to display the change package information.  This will display your change package.

On this panel, you can view the status,  approvers, SCL, cast report and backout information related to a package.

Workshop Practice #1

1)  What is the Status of the package?          ________


What You Do
Comments/Prompts
Press PF3
This will return you to the Package Foreground Options Menu.
Select 3 (Cast) and press ENTER
Now that you have created the package, you need to perform a Cast.



What You Do
Comments/Prompts
Enter C on the option line and press ENTER
This will perform the cast of the package.  This will return you to the Package Options Menu.  Check the upper right hand corner for a Cast Successful message.
Press PF3
This will return you to the Package Foreground Options Menu.
Select 1 and press ENTER
This will display the change package information.


Workshop Practice #2

1)  What is the status of your package?  ______________

Approvals are required after the change package is Cast.  In our class configuration, the instructor will approve everyone’s package.  Ask your instructor to approve your package at this time.




What You Do
Comments/Prompts
Press PF3
You want to return to the Package Foreground Options Menu.
Select 5 (Execute) and press ENTER
Now that the package is approved, it is ready to be executed.
Select E and press ENTER
You can either execute the package in foreground or batch.  For simplicity, we will execute the package in foreground.


What You Do
Comments/Prompts
Check the change package execution messages on-line
You want to verify a successful execution.  Remember that this package is performing a MOVE.  This setup of Endevor will perform a compile and link of the COBOL program during the move.
Max down to the bottom to check for return codes (M and PF8)
This is where you can find all the Endevor messages for you job


Workshop Practice #3

1)  What was the Endevor return code from the change package execution?  ___________


CONGRATULATIONS!  You have now completed the Change Package workshop.  You created, cast, reviewed, and executed your change package.  As you have learned from this workshop, it is easy to move inventory through its life cycle by using change packages.  The same process you just used can be used to move inventory at your account.

The next section will focus on the screens to perform parallel development with Endevor.

Logging Off

You are now ready to log off.

What You Do
Comments/Prompts
Press PF3
This will return you to the Package Options Menu.
Press PF3
To return to the Endevor Primary Options Menu panel
Press PF3
To Exit and it returns you to the Endevor Implementation Selection Menu
At the command line type  =x and press ENTER
You are now at the ISPF/PDF Primary Options Menu
At the  command line type =x and press ENTER
READY should be on the screen at this point
Type logoff  and press ENTER
To logoff


*** END OF WORKSHOP ***

0 comments:

Computers TopOfBlogs Technology Blogs Mainframe interview question and answers,mainframe jobs,cobol,vsam,jcl,cics,db2,rdbms,mvs,tso,ispf,ibm,hcl,tcs,cts,wibro Blog Directory