Endeavor Workflow
Endeavor Workflow
Endeavor Workflow
(VERSION 1.0)
TABLE OF CONTENTS
1 INTRODUCTION.......................................................................................................1
2 OVERVIEW................................................................................................................3
2.1 ENVIRONMENTS AND STAGES...........................................................................................................3
3 ROLES AND RESPONSIBILITIES.........................................................................4
11 APPENDIX................................................................................................................63
11.1 DEFINITIONS....................................................................................................................................63
11.2 NAMING CONVENTIONS..................................................................................................................63
11.3 SOME FACTS RELATED TO BARS APPLICATIONS...........................................................................64
SE Workflow Document Introduction
1 Introduction
2 Overview
CA – Endevor helps to manage the software life cycle by providing a consistent and
flexible logical structure for classifying software inventory. There are six components in
the inventory structure: environments, stages, systems, subsystems, types and elements.
Environments, stages, systems, subsystems and types are setup by the CA-Endevor
administrator. SEs act on elements.
CA-Endevor allows you to automate and control the movement of software through SLC.
Software Life Cycles are site/application specific. A representative cycle might consist of
two environment (CCCC TEST and CCCC PROD) and four stages (PROD, FIX, TEST
and HOLD) shown below.
The following diagram illustrates the Environments & Stages:
CCCC TEST CCCC PROD
PROD: Elements Retrieved and Moved back from Hold and FIX.
TEST: Programs/Elements are tested after changes(added/updated )
HOLD: QA takes place.
FIX: Emergency Fixes are made and tested
Note:
Refer section # 5 “Definition/Acronyms/Naming Conventions” for more details about
Environment, Stage, System, Subsystem and Types.
SE Workflow Document Roles and Responsibilities
4.1.2 Batch
Select 3, BATCH in the CA-Endevor Primary Option Menu and hit ENTER, it takes
you to the BATCH OPTIONS MENU
In this panel, select the action you want to perform by entering the action number.
SE Workflow Document Software Control Language
To edit the SCL, select 2, EDIT in the BATCH OPTION MENU. You must specify
the dataset you want to edit using the REQUEST DATA SET or OTHER
PARTITIONED OR SEQUENTIAL DATASET field
4.3 PACKAGES
Description:
A Package is a set of CA-Endevor actions that may require approval before being
executed
4.3.1 Creation
In-Approval..... Y Executed..….... Y
Denied..…...... Y Committed..…... Y
Approved……..Y
-------------------------------------------------------------------------------
4.3.2 Casting
When you cast the package, CA-Endevor
Determines approvers
Validate Package Components (optional)
Check action security
Check Component integrity
Description:
After casting, if the Package requires approval CA-Endevor change the Package to
IN-APPROVAL, If the Package does not require an approval, it’s status change to
APPROVED
After a Package has been cast, it can be approved and then executed.
Procedure:
You must cast a Package after creating it
SE Workflow Document Packages
Select 3 to CAST the Package in the Package Foreground Option Menu, it takes you
to ‘CAST PACKAGE’ Panel. Select C to cast the package.
VALIDATE COMPONENTS = ‘Y’ means validate components and do not allow the
cast if validation fails, ‘N’ does not validate components. ‘W’ does the validation but
does not fail the cast if validation fails. Hit ENTER
Check any cast warning/errors carefully. If the casting is successful you will get a
message CAST SUCCESSFUL
4.3.3 REVIEW/APPROVAL/DENIAL
Description:
If one or more approver groups are associated with the inventory area(s) included in
the packages, then Package must be reviewed and approved before it is executed. To
be approved, it must be accepted by all the approvers or at least by the necessary
approver(s)
The Approver(s) can approve or deny the Package
After getting the required approver(s) approval the Package may be executed by the
approver
SE Workflow Document Packages
4.3.4 EXECUTE/SUBMIT
Description:
This is the exact step that does the CA-Endevor action what you want to do
To Execute:
To execute a Package, you must have the authority to execute the Package and also
have the authority to perform the action contained in the Package
The Package must be in status APPROVED
Available Modes:
Packages can be executed in Foreground or Background
How to Execute?
Select 5 in the CA-Endevor Primary Option Menu. Type the Package-id to go directly
to the
EXECUTE/SUBMIT PACKAGE panel
Foreground Execution:
To execute a package online, select ‘E’ in the EXECUTE/SUBMIT PACKAGE panel
A message appears in the upper right corner of the panel indicating whether the
Package executed successfully or not
The status of the package is changed to Executed, if execution was successful. If there
is an execution error, the status is changed to Exec Failed
After execution, hit ENTER to display the first page of the CA-Endevor Package
Execution Report. Press END to return to the CA-Endevor Primary Option Menu
Batch Execution:
To execute a Package in Batch, select ‘S’ in the EXECUTE/SUBMIT PACKAGE
panel and hit ENTER
It takes you to SUBMIT PACKAGE panel, select ‘S’ to submit the Package or select
‘E’ to include additional JCL with the Job and hit ENTER
SE Workflow Document Packages
To include JCL in the JOB STATEMENT INFORMATION field you can include
The status of the package is changed to Executed, if execution was successful. If there
is an execution error, the status is changed to Exec Failed
Depends on the system you works you may receive a message indicating that your job
has been submitted
SUBMIT-----------------------------SUBMIT PACKAGE----------------------------------------------
OPTION ===>
S – Submit job for batch processing
E – Enter additional JCL to be include with the job
PACKAGE ID: package-id
DESCRIPTION: description about the package
PACKAGE TYPE: type of the package
INCLUDE JCL ===> N (Y/N)
JOB STATEMENT INFORMATION:
===> // jobcard information
===> //
===> //
===> //
----------------------------------------------------------------------------------------------------------------
4.3.5 Commit
Description:
Commit is the last stage in Package life cycle
When package outputs are acceptable in their current stage, you can commit the
Package
SE Workflow Document Packages
What it does?
It removes all backout/backin data for the Package
After commit you can no longer be backed out, shipped or collected
Once a Package is Committed, its dependent Packages (If any) can no longer be
backed out or backed in
How to commit?
Enter the Package name in the PACKAGE-ID field of the Package Foreground
Option Menu and select 8, hit ENTER it takes you to COMMIT PACKAGE panel
To see the Package selection list leave the Package–id field blank and hit ENTER
It will list the Packages available for your userid. Select the package you want to
commit then hit ENTER
To commit the package, select C in the COMMIT PACKAGE panel and hit ENTER
The Package is committed and the status of the Package is set to ‘COMMITED’
4.4 RETRIEVE
Description:
RETRIEVE gets a copy of the source from Production library in to a dataset
How to retrieve?
RETRIEVE can be performed in Foreground or Batch
Foreground:
Select 2, FOREGROUND in the CA-Endevor Primary Option Menu, It takes you to
Foreground Options Menu
select 3, to RETRIEVE, It takes you to RETRIEVE ELEMENTS panel
Enter ‘R’ to retrieve
Enter the environment, system, subsystem, type, stage-id and element name of the
element to be retrieved
Other than ENVIRONMENT field, all the other fields can be left blank to get a list
If you get a list enter ‘R’ before the element name to be retrieved
Enter a valid CCID and a meaningful comment in the respective field
Signout is important. Enter signout as Yes (Default). If you don’t signout, you can’t
ADD
Enter your dataset name where the retrieved member is going to be placed in the field
TO ISPF LIBRARY
You will get a message ‘Retrieved’, if retrieval is successful
Batch:
Select 3, BATCH in the CA-Endevor Primary Option Menu
It takes you to BATCH OPTION MENU
Build SCL (As explained in sec.x.x) and submit it from this panel for Action Retrieve
ii. From the CA-Endevor Foreground Option Menu select 1 (By selecting 2
in the CA-Endevor Primary Option Menu you got this Foreground Option
Menu) it takes you to Display Elements /Component Lists panel
In the Display Elements /Component Lists panel, specify the details related to the
element like Environment, System, Subsystem, Type and Stage-id. You can leave any
fields other than ENVIRONMENT. It will list all the details about the elements like
version, level and other details.
Batch:
From the CA-Endevor Primary Option Menu select 3 for BATCH OPTIONS MENU
In the BATCH OPTION MENU select Build SCL (as in sec.xx) and submit for the
action ADD /UPDATE.
Refer sec # xx for further steps to continue in BATCH OPTIONS MENU.
SE Workflow Document Move
4.7 Move
Description:
MOVE action moves elements from one inventory area to the next inventory area on a
map route.
Availability:
Move action can be performed in foreground, batch or packages. A package move is a
must when the element is moved to production.
Foreground:
From Primary Options Menu, select 2, FOREGROUND, CA-Endevor displays the
Foreground Options Menu.
From Foreground Options Menu select 5, MOVE.
Specify the ENVIRONMENT, SYSTEM, SUBSYSTEM, ELEMENT, TYPE and
STAGE ID of the source stage to define the element to move.
Make sure that the following ACTION OPTIONS are completed:
CCID is as per the naming conventions.
SYNC = N (Default)
Note: SYNC = Y, when the base level of the element at the source location
is different from the current level of the element at the target.
WITH HISTORY = N
RETAIN SIGNOUT = N (Default. This option does not retain the source
location Signout at the target location.)
SIGNOUT TO = N (Default)
Note: If RETAIN SIGNOUT = Y, you cannot use this option.
ACKNOWLEDGE ELM JUMP = N
DELETE FROM ELEMENT = Y
Caution: If DELETE FROM ELEMENT = N then you must specify SYNC
= Y for any subsequent moves of this element.
The MOVE ELEMENTS panel is shown below:
SE Workflow Document Move
Batch:
From Primary Options Menu, select 3, BATCH.
From Batch Options Menu, select 1, BUILD SCL.
From SCL Generation panel, select 5, MOVE. CA-Endevor displays the Move
Elements panel.
Refer sec # xx for further steps in BATCH OPTIONS MENU.
Package:
To MOVE elements through package refer sec. xx for further steps to continue.
SE Workflow Document Generate
4.8 GENERATE
Description:
Creates an executable form of an element.
Availability:
Generate can be performed in Foreground or Batch.
Foreground:
From Primary Options Menu, select 2, FOREGROUND.
From Foreground Options Menu, select 4, GENERATE ELEMENTS panel to execute
the Generate Processor for the element.
Fill the ENVIRONMENT, STAGE fields where the element is to be generated.
COPY BACK = N (Default) it does not copy back the element.
Note: COPY BACK = Y (This option copies the element back from Stage 2, or the
first time it is found up the map, to the FROM stage and generate it at that stage).
OVERRIDE SIGNOUT = N, (Default). This option does not generate the element if it
is not signed out to you. OVERRIDE SIGNOUT = Y, this is to generate the element,
even if it is not signed out to you.
PROCESSOR GROUP = *
Note: If you do not provide a processor group name, CA-Endevor selects the
existing group associated with the element if the element exists in Stage 2 or
further up the map, or the default group for the element type.
OPTION ===> G to generate the element.
Batch:
From Primary Options Menu, select 3, BATCH.
From Batch Options Menu, select 1, BUILD SCL.
From SCL GENERATION panel, select 4, GENERATE. CA-Endevor displays the
Generate Elements Panel.
Refer sec # xx for further steps to continue in BATCH OPTIONS MENU.
SE Workflow Document Delete
4.9 DELETE
Description:
Erases base/delta forms of an element and removes related information from Master
Control File or component list
Availability:
DELETE action can be performed in Foreground or Batch.
Foreground:
From Primary Options Menu, select 2, FOREGROUND.
From Foreground Options Menu, select 6, DELETE. CA-Endevor displays the Delete
Elements panel.
Choose OPTION ===> # to Delete an element
Specify the ENVIRONMENT, SYSTEM, SUBSYSTEM, ELEMENT and TYPE.
Make sure that following ACTION OPTIONS are completed.
CCID is given as per the naming conventions associated with the action.
OVERRIDE SIGNOUT= N (Default). This option does not delete the
element if it is not signed out to you.
ONLY COMPONENT = N (Default). This option deletes the element as
well as the element component list.
Batch:
From Primary Options Menu, select 3, BATCH.
From Batch Options Menu, select 1, BUILD SCL. From the SCL Generation panel,
select 6, DELETE. CA-Endevor displays the Delete Elements panel.
SE Workflow Document Delete
TYPE ===>
STAGE ===> T - TEST P - PROD
LIST OPTIONS:
DISPLAY LIST ===> Y (Y/N)
WHERE CCID EQ ===>
WHERE PROC GRP EQ ===>
WHERE USER EQ ===>
BUILD USING MAP ===> N (Y/N)
----------------------------------------------------------------------------------------------------------------------------------------------
Following are the signout, signout override action options incorporated in various
actions.
Add/Update:
OVERRIDE SIGNOUT =N (Default).This option does not add/update the element if
it is not signed out to you.
Retrieve:
SIGNOUT ELEMENT = Y(Default).This option retrieves the element but does not
sign it out to your userID.
OVERRIDE SIGNOUT= N(Default).This option retrieves the element, even if it is
not signed out to you.
Generate:
OVERRIDE SIGNOUT= N(Default).This option does not generate the element if it is
not signed out to you. If OVERRIDE SIGNOUT= Y, it generates the element, even if
it is not signed out to you.
Move:
RETAIN SIGNOUT = N(Default).This option does not retain the current signout.
CA-Endevor signs in the element at the target location. RETAIN SIGNOUT=Y, retain
the signout. CA-Endevor does not sign in the element at the target location.
SIGNOUT TO= N(Default). If RETAIN SIGNOUT = Y, you cannot use this option.
SIGN IN/OUT/OVERRIDE
Delete:
OVERRIDE SIGNOUT = N(Default).This option does not delete the element if it is
not signed out to you. If OVERRIDE SIGNOUT =Y, it deletes the element, even if it
is not signed out to you.
SE Workflow Document SIGNIN/OUT/OVERRIDE
Batch:
Sign in:
From the Primary Options Menu, select 3, BATCH.
From Batch Options Menu, select 1, BUILD SCL.
From SCL Generation panel, select 8, SIGNIN. CA-Endevor displays the Signin
Elements panel.
Refer sec # xx for further steps to continue in BATCH OPTIONS MENU.
Add/Update:
From the Primary Options Menu, select 3, BATCH.
From the Batch Options Menu, select 1, BUILD SCL.
From the SCL Generation panel, select 2, ADD/UPDATE.
Refer sec # xx for further steps to continue in BATCH OPTIONS MENU.
Retrieve:
From Primary Options Menu, select 3, BATCH.
From Batch Options Menu, select 1, BUILD SCL.
From the SCL Generation panel, select 3, RETRIEVE.
Refer sec # xx for further steps to continue in BATCH OPTIONS MENU.
Generate:
From Primary Options Menu, select 3, BATCH.
From Batch Options Menu, select 1, BUILD SCL.
From SCL Generation panel, select 4, GENERATE.
Refer sec # xx for further steps to continue in BATCH OPTIONS MENU.
Move:
From Primary Options Menu, select 3, BATCH.
From Batch Options Menu, select 1, BUILD SCL.
From SCL Generation panel, select 5, MOVE.
Refer sec # xx for further steps to continue in BATCH OPTIONS MENU.
Delete:
From Primary Options Menu, select 3, BATCH.
From Batch Options Menu, select 1, BUILD SCL.
From SCL Generation panel, select 6,DELETE.
SE Workflow Document SIGNIN/OUT/OVERRIDE
5 Procedures To Follow
5.1 Standard Change Overview
Following are the steps to be followed when SEs does the actions in Standard
Development.
Retrieving elements from production to a development library (PDS).
Making changes to elements in PDS.
Adding/Updating elements into the test stage.
Moving elements to hold stage.
Moving elements from hold stage back to production.
TEST PROD
T H F P
PDS
Figure 1
in progress PDS or Pacbase. In either case, you will need to repeat Steps 5 and 6 as
many times as necessary.
7. Perform this step if using XPEDITER
When testing is complete, an UPDATE will be necessary to Environment GC01PTST,
stage TEST if the element was last ADDed using the XPEDITER processor group.
When performing the UPDATE to compile without XPEDITER, you must choose the
non-XPEDITER processor group since Endevor remembers and reuses the previous
processor group.
8. Perform this step if using Pacbase.
When testing is complete, an UPDATE will be necessary to Environment GC01PTST,
stage TEST if the element is a Pacbase element. This UPDATE will be performed in
order to have Endevor pull the source from the appropriate Pacbase frozen session.
The frozen session number is placed in the Endevor pseudo source located within the
SE’s work in progress PDS.
Additional testing may be necessary in order to validate this new compile/link.
9. The SE BUILDs a Change Package using the appropriate Change Package ID. For
assistance with change package IDs, see the section titled ‘Naming Conventions’.
The Change Package will move the elements from the GC01PTST Environment,
TEST Stage to the GC01PTST Environment, MOFC Stage. You can choose the
elements to include within the Change Package by selecting all elements associated
with one or more CCIDs or you can individually select elements without using the
‘Where CCID EQ’ list command.
Create your packages with a package type of ‘Standard’
Make your packages ‘shareable’ and enable ‘backout’
Fill in an appropriate execution window
Choose the appropriate ENDEVOR actions and elements
10. The SE CASTs the Change Package. If cast errors occur, the SE views the cast report
through the package display option and corrects any problems.
11. After successfully casting the package, the package creator notifies the System
Assurance (SA) group that the change package is ready for approval. The person
creating the Change Package provides the approvers with the change package ID and
SE Workflow Document Standard Change Overview
related documentation. Valid approvers and the package status can be viewed from
the package display option.
12. The SA group, prior to approving the change package, reviews the actions which will
be performed in the package by using the ‘display action summary option’. If the
approver agrees the appropriate testing has been performed, the correct Endevor
actions are being performed and the date and time when the actions will be performed
is correct, the SA group approves the change package.
Caution: A scheduled batch job may be in place which will execute all approved
packages. Do not approve this package until it is time for it to be executed.
13. The scheduled package execution job or the SA group approver submits the change
package through the Endevor Foreground Package Options panel in order to perform
the actions within the package (MOVE elements from the GC01PTST environment,
TEST stage to the GC01PTST environment, MOFC stage). If the approver executes
the package, the approver chooses option ‘5’ Execute Package option. The approver
then chooses the ‘submit package’ option. Next, choose option ‘E’ (Enter additional
JCL to be included with the job). The JCL to be included is the LLA refresh JCL.
The JCL to be entered should look like this (just one line):
//JS010 EXEC PGM=LLA001,PARM='LLA001I DA'
After entering the JCL press enter and then PF3. Select ‘Include JCL - Y’ and then
option ‘S’ (Submit job for Batch Processing). This will submit a job which will cause
the package to be executed.
14. The Change Package submitter is responsible to review the package execution log to
ensure all processing completed successfully.
15. The Change Package submitter is also responsible to COMMIT the package when
package backout is no longer required for this package. This will clean up the
encrypted backout members in the source and load output libraries. After a COMMIT
is performed, a backout of this package will not be possible.
16. The SA group directs the joint acceptance or Model Office testing. If an error is
found, the SE will RETRIEVE the element from the GC01PTST environment,
MOFC stage and modify the element in their work in progress PDS. The SE will
SE Workflow Document Standard Change Overview
ADD the element into stage TEST (a compile will be performed). The SE will
perform some level of testing and then request the SA group MOVE the element back
to the MOFC stage. The move of the corrected element(s) (by the SA group) to the
MOFC stage is performed through a package as described in steps 9 through 15.
These steps can be repeated as many times as necessary.
17. When the SA group has proven the production support changes to be problem free,
the SA group BUILDs a Change Package using the appropriate Change Package ID.
For assistance with change package IDs, see the section titled ‘Naming Conventions’.
The Change Package will move the elements from the GC01PTST Environment,
MOFC Stage to the GC01PROD Environment, PROD Stage. You can choose the
elements to include within the Change Package by selecting all elements associated
with one or more CCIDs or you can individually select elements without using the
‘Where CCID EQ’ list command.
Create your packages with a package type of ‘Standard’
Make your packages ‘shareable’ and enable ‘backout’
Fill in an appropriate execution window
Choose the appropriate ENDEVOR actions and elements
18. The SA group CASTs the Change Package. If cast errors occur, the SA group views
the cast report through the package display option and corrects any problems.
19. After successfully casting the package, the SA group notifies the Production Support
(PS) group that the change package is ready for approval. The SA group provides the
PS group with the change package ID and related documentation. Valid approvers
and the package status can be viewed from the package display option.
20. The PS group, prior to approving the change package, reviews the actions which will
be performed in the package by using the ‘display action summary option’. If the
approver agrees the appropriate testing has been performed, the correct Endevor
actions are being performed and the date and time when the actions will be performed
is correct, the PS group approves the change package.
Caution: A scheduled batch job may be in place which will execute all approved
packages. Do not approve this package until it is time for it to be executed.
SE Workflow Document Standard Change Overview
21. The scheduled package execution job or the PS approver submits the change package
through the Endevor Foreground Package Options panel in order to perform the
actions within the package (MOVE elements from the GC01PTST environment,
MOFC stage to the GC01PROD environment, PROD stage). If the approver executes
the package, the approver chooses option ‘5’ Execute Package option. The approver
then chooses the ‘submit package’ option. Next, choose option ‘E’ (Enter additional
JCL to be included with the job). The JCL to be included is the LLA refresh JCL.
The JCL to be entered should look like this (just one line):
//JS010 EXEC PGM=LLA001,PARM='LLA001I GA'
After entering the JCL press enter and then PF3. Select ‘Include JCL - Y’ and then
option ‘S’ (Submit job for Batch Processing). This will submit a job which will cause
the package to be executed.
22. The Change Package submitter is responsible to review the package execution log to
ensure all processing completed successfully.
23. The Change Package submitter is also responsible to COMMIT the package when
package backout is no longer required for this package. This will clean up the
encrypted backout members in the source and load output libraries. After a COMMIT
is performed, a backout of this package will not be possible.
24. After the change package is moved to production and the production support changes
are shown to be working properly, the SE works with other SEs performing release
development to bring their copies of the changed modules up to date. This is done in
order to prevent regression.
SE Workflow Document Emergency Change Overview
TEST PROD
T H F P
PDS
and the emergency fix SE reminding them to speak with each other concerning what
fixes need to be made to the code being developed.
4. The SE edits the elements in their work in progress PDS or within Pacbase.
Note: If using Pacbase, be sure to update the Endevor pseudo source that you
retrieved earlier. It contains the Pacbase element name, the Pacbase library and the
Pacbase frozen session number.
5. The SE in batch or foreground, ADDs/UPDATEs the elements into the GC01PROD
Environment/FIX Stage using the appropriate CCID number and comments. If using
Pacbase, Endevor will extract the element from Pacbase.
If using Pacbase, the SE should choose not to delete the source element from their
work in progress PDS if they would like to take a frozen session number later during
this emergency fix. This is because an update to this Endevor pseudo source will be
necessary after testing is complete. The update will be to place the Pacbase frozen
session number within these control statements.
If the element you are adding will be compiled, you must add the element using the
Endevor batch options.
For a processor group selection list (to use XPEDITER), enter an asterisk (*) in the
processor group field on the ADD/UPDATE panel. If no processor group is entered
on this panel (for this particular element), the previously used processor group will be
used for existing elements, the default processor group will be used for new elements.
Source programs will be compiled or assembled automatically.
Review the compile or assemble listing in SAM. If batch processing was used to
ADD/UPDATE, the listing(s) will be located in the batch job output. If foreground
processing was used, the listing(s) will be located in the SAM output area, under your
TSO ID. For information on how to see detailed information on program inputs and
outputs, see the section titled: ‘Automated Configuration Manager’ or see the
Endevor/MVS ACM manual.
6. The SE performs Unit Testing. If an error is found and you chose ‘Delete Input
Source’ in step 5, Retrieve the element from the GC01PROD environment, FIX stage
and modify the element in your work in progress PDS or in Pacbase. If you did NOT
choose ‘Delete Input Source’ in step 5, simply modify the element in your work in
SE Workflow Document Emergency Change Overview
progress PDS or Pacbase. In either case, you will need to repeat Steps 5 and 6 as
many times as necessary.
7. Perform this step if using XPEDITER
When testing is complete, an UPDATE will be necessary to Environment
GC01PROD, stage FIX if the element was last ADDed using the XPEDITER
processor group. When performing the UPDATE to compile without XPEDITER,
you must choose the non-XPEDITER processor group since Endevor remembers and
reuses the previous processor group.
8. Perform this step if using Pacbase.
When testing is complete, an UPDATE will be necessary to Environment
GC01PROD, stage FIX if the element is a Pacbase element and you wish to take a
Pacbase frozen session. This UPDATE will be performed in order to have Endevor
pull the source from the appropriate Pacbase frozen session. The frozen session
number is placed in the Endevor pseudo source located within the SE’s work in
progress PDS.
Additional testing may be necessary in order to validate this new compile/link.
Note: Emergency fixes should be executed from the PROD stage (and production
libraries) if either of the following conditions are met:
If the type being fixed is DB2 related
If the correction is to an on-line module
All other fixes may be executed from the FIX stage (and fix libraries).
If you are moving these elements to the PROD stage, continue with step 9.
9. The SE BUILDs a Change Package using the appropriate Change Package ID. For
assistance with change package IDs, see the section titled ‘Naming Conventions’.
The Change Package will move the elements from the GC01PROD Environment,
FIX Stage to the GC01PROD Environment, PROD Stage. You can choose the
elements to include within the Change Package by selecting all elements associated
with one or more CCIDs or you can individually select elements without using the
‘Where CCID EQ’ list command.
Create your packages with a package type of ‘Standard’
Make your packages ‘shareable’ and enable ‘backout’
SE Workflow Document Emergency Change Overview
16. After the change package is moved to production, the SE directs the abend resolution
with batch scheduling or other operations area.
17. After resolving the abend, the SE works with other SEs performing release
development or standard production support changes to bring their copies of the
changed modules up to date. This is done in order to prevent regression.
SE Workflow Document CA-Endevor Quick-Edit
6 CA-ENDEVOR QUICK-EDIT
The Action Options panel displays when you select option AO, Action Options from the
CA-Endevor Quick-Edit panel. You use this panel to further define the following action
requests:
Move
Generate
Delete
6.1 MOVE
Use the MOVE option to move an element from one CA-Endevor inventory location to
the next location along the map route. The MOVE option is available from the CA-
Endevor Quick-Edit panel and the Element Selection List panel.
To move an element, type O in:
The Command field on the CA-Endevor Quick-Edit panel.
The Selection field next to the desired element on the Element Selection List panel.
Press ENTER.
When MOVE action is used for the first time, make note of the following information:
The Move action moves elements from one inventory location (environment, stage) to the
next location on a map route.
You can move elements either with history or without history by specifying the With
History option on the Actions Options panel (see the section entitled "Action Options
Panel").
You can only move elements from one environment to another if the elements start in
Stage 2 of the source environment. So, for example, to move an element from Stage 1
of the Development environment into Stage 1 of the QA environment, you have to
move the element to Stage 2 in Development and then move it into Stage 1 in QA.
You can move elements in foreground, or in batch by specifying which Move action
mode on the Actions Options panel.
Use the Action Options panel to further define the type of move processing you want
to perform. See the section entitled "Action Options Panel" for information on
available Move action options.
SE Workflow Document CA-Endevor Quick-Edit
6.2 GENERATE
To generate an element, type G in the appropriate place:
On the COMMAND line of the CA-Endevor Quick-Edit panel
In the SELECTION field next to the element(s) desired, on the Element Selection List
Press ENTER.
6.3 DELETE
Use the Delete option to delete elements and/or an element component list from CA-
Endevor. The Delete option is available from the CA-Endevor Quick-Edit panel and
Element Selection List panel.
To delete an element, type #, in:
The Command field on the CA-Endevor Quick-Edit panel.
The Selection field next to the desired element on the Element Selection List panel.
Press ENTER.
When performing DELETE action makes note of the following information:
SE Workflow Document CA-Endevor Quick-Edit
Use the Delete action to delete all levels of an element, any associated processor
outputs from either stage or, if you are using the CA-Endevor Automated
Configuration Manager (ACM), the component list for the element. If you are using
ACM, you can also elect to delete only the component list for an element.
You can delete elements in foreground, or in batch by specifying the Delete action
mode on the Actions Options panel.
Use the Action Options panel to further define the type of delete processing you want
to perform.
SE Workflow Document Parallel Development Manager
The first step in using the Parallel Development Manager is to build the Work-in-
Process (WIP) file and analyze the results. The WIP file is produced by comparing
the Root (or base) file against one or two Derivation (modified) files. The WIP file
combines the Root file and every insertion and deletion that has been made to the
Derivation file(s), noting conflicting changes i.e. when building the WIP file, CA-
PDM uses the Derivation 1 and Derivation 2 files to determine which lines to include
in the WIP file.
The build WIP process analyzes the input files, identifies differences and conflicts,
and creates statistics and reports. Once the WIP is edited to resolve conflicts, CA-
PDM can create an integrated output file by inserting and deleting lines based on the
annotations in the WIP file, and write the integrated output file to a user specified
location.
7.1.1 Structure of a WIP file
A WIP file contains
Header
Annocations
Rest of WIP file
SE Workflow Document Parallel Development Manager
When you have finished editing the WIP File, press PF3; the Edit – Entry Panel
reappears. The message Member Saved appears in the upper right-hand corner of the
screen. This message indicates that the edited WIP member has been saved. Press PF3 to
return to the CA-Parallel Development Manager - Primary Option Menu.
foundation for all software configuration analysis and management activities, including:
Analyzing system behavior
Propagating a component change to all affected programs
Validating a system for consistent use of components
Recreating past program versions
Moving related source components during promotion to production
CA-Endevor ACM functions can be separated into the following three categories:
Monitoring and Collecting Data--performed automatically by the CA-Endevor ACM
Component Monitor
Storing and Viewing Configuration Information--capabilities provided by CA-
Endevor ACM through Component Lists and base/delta technology
Analyzing and Managing Configuration Information--performed by users, with
configuration information automatically monitored and stored by CA-Endevor ACM.
//SYSLIB DD
DSN=BST.C1DEMO.COPYLIB1,DISP=SHR,MONITOR=COMPONENTS
// DD DSN=BST.C1DEMO.COPYLIB2,DISP=SHR,MONITOR=COMPONENTS
//SYSLMOD DD
DSN=BST.C1DEMO.LOADLIB1,DISP=SHR,MONITOR=COMPONENTS
CONWRITE
IKFCBL00
IEWL
CONLIST
SE Workflow Document Automated Configuration Management
Symbol Information--the symbolics that have been defined by the user for this
processor. It tells you the symbolic, the value that will be substituted for it when the
processor is run, and where that value has been defined -- either directly in the PROC
statement of the processor or as overridden through the Processor Group Symbolics
panel.
Input Components--the members in the monitored data sets which are read by
programs (such as the compiler or linkage editor) in the CA-Endevor processor when
it collects components to build composite modules. It tells you the related "pieces" of
the element and where they came from.
Output Components--the monitored data sets which are written to by programs
(such as the linkage editors or CA-Endevor utilities) when composite modules are
created. It tells you the members created during processor execution.
SE Workflow Document Common Errors and their Solutions
EM 01. C1G0167E
ERROR MESSAGE :
FINARP01 IS NOT AVAILABLE. IT HAS BEEN PREVIOUSLY SIGNED OUT BY TETRN04
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT :
Sol.
THIS MESSAGE IS ISSUED BECAUSE USER TETRN04 HAS RETRIEVED
FINARP01 WITH SIGNOUT OPTION ‘Y’.
PROBABLE SOLUTIONS :
1) Call user tetrn04 and ask him to sign in finarp01
2) If unable to reach him use override signout option in case it is emergency.
EM02. C1G0126E
ERROR MESSAGE :
NO REPLACE SPECIFIED AND FINARP01 WAS FOUND IN
TETRN01.PDS.WIP
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT:
Sol.
Cause: A Retrieve request for element FINARP01 found a member with that name
already present in the data set TETRN01.PDS.WIP.
To fix: Re-execute the request, using a different data set as the destination, or allow
the present element FINARP01 to be replaced.
EM03. C1G0168E
ERROR MESSAGE :
FINAPP02 CANNOT BE ADDED BECAUSE IT IS NOT IN "SIGNED-OUT"
STATUS
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT:
SE Workflow Document Common Errors and their Solutions
Sol.
Cause: An Add was attempted for element FINAPP02, but was rejected because the
element FINAPP02 exists elsewhere on the map, but has not been signed out.
To Fix: Retrieve the element, then resubmit the Add request.
EM04. C1G0024E
ERROR MESSAGE :
ELEMENT FINARP01 ALREADY PRESENT AT UT:
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT:
Sol.
Cause: An Add request specified for the element FINARP01 is already present in
UT stage.
To Fix: Review the action request. Verify that the element specified for an Add
request is the correct one, and modify the request if appropriate. If a different action
was intended, correct the request and resubmit.
DURING MOVE
EM06.
ERROR MESSAGE :
THE MOVE ACTION CANNOT BE PERFORMED - PROC GRP
EXPEDITOR NOT DEFI NED FOR TYPE COBOL AT STG Q
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT :
Sol.
Cause : Processor group EXPEDITOR defined by the user for TYPE COBOL is not
available.
To Fix: Check the available Processor group for TYPE COBOL and give the exact
available processor.
DURING MOVE
EM07. FPVL003E
ERROR MESSAGE:
NO FOOTPRINT MATCH AVAILABLE ANYWHERE
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT?
Sol.
Cause: No Master Control File records for the element matches the location and
event information in the footprint. If of the other related components of the elements
are not foot printed, that may cause this problem.
To Fix: Compile all the related components to get footprint and redo the process.
Check the Environment, Site ID, Stage-ID, System, Sub system, Type what you
specified.
DURING ADD
EM08. C1U0900E
ERROR MESSAGE:
EXIT 2 -ACTION DENIED - INVENTORY AREA FINANCE -ACCTREC
-COBOL 2 PACKAGE UPDATE ONLY
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT?
SE Workflow Document Common Errors and their Solutions
Sol.
Cause: The specified inventory area for which an action is being requested has an
approver group relationship so action denied.
To Fix: Delete the relationship between the inventory area and the approver group, or
use package processing to update the inventory area.
DURING MOVE
EM09. CIX0104E
ERROR MESSAGE :
JUMP OPTION IS REQUIRED FOR SYSTEM GMBRRIN TO BYPASS THE
ELEMENT IN THE PHYSICAL PATH
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT ?
Sol:
Cause: The system named in the message requires that move actions be specified
with JUMP=Y when CA- Endevor has encountered a version of the element(s) to be
moved in a mapped environment but not on the map itself.
To Fix: Resubmit the move request with JUMP=Y.
EM10. PKMR403E
ERROR MESSAGE:
TARGET ON MOVE ACTION DOES NOT EXIST FROM ENV:DEMO PROD
SYS FINANCE STG P
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT ?
Sol:
Cause: No target location exists for the environment, system, subsystem, type, and
stage specification in the message.
To Fix: Make sure the from location is specified correctly, then resubmit the move
request.
SE Workflow Document Common Errors and their Solutions
EM11. PKMR516E
ERROR MESSAGE:
INTEGRITY ERROR:
FINARP01 HAS BEEN MODIFIED SINCE THE PACKAGE WAS CAST -
TETRN01.PDS.WIP
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT ?
Sol:
Cause: The data set in the message has been modified since the package was cast.
To Fix: Reset, recast, and reprove the package.
DURING CASTING
EM12: PKMR509E
ERROR MESSAGE :
STMT#2 ELM HEADER01 NOT FOUND AT
DEMOTEST/FINANCE/ACCTREC/COPYBOOK/QA
STMT#3 ELM PAGEHDR NOT FOUND AT
DEMOTEST/FINANCE/ACCTREC/COPYBOOK/QA
STMT#1 ELM FINARPJK NOT FOUND AT
DEMOTEST/FINANCE/ACCTREC/COBOL/QA
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT ?
Sol:
Cause: The element specified in the statement identified in the message was not
found at the specified CA-Endevor location.
To Fix: Ensure that the element and/or CA-Endevor location is specified correctly.
DURING RETRIEVAL/GENERATE
EM13. C1G0030E
ERROR MESSAGE:
C1G0030E UNABLE TO VERIFY FOOTPRINT FOR ELEMENT FINARP12
IN THE ELEMENT BASE L
SE Workflow Document Common Errors and their Solutions
EM14. C1G0129E
ERROR MESSAGE:
STEP COMPILE RC (0012) EXCEEDS THE MAX RC (0004) FOR THE
PROCESSOR STEP
PROCESSOR C2XXXXGW EXECUTION COMPLETED, HIGHEST
PROCESSOR STEP RC WAS 0012
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT ?
Sol:
Cause: The named step in a processor resulted in a return code (RC 0012) that is
greater than the maximum acceptable return code (RC 0004) for that step in the
processor definition. CA-Endevor set a "processor failed flag."
To Fix: Examine the processor output and messages to determine the cause of the
error. Correct the error conditions and resubmit the request.
EM15. C1G0129E
ERROR MESSAGE :
CPXUPTSM MODULE NOT FOUND IN STEP COMPILE
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT?
Sol:
Cause: The module CPXUPTSM was not found, because of that the step in a
processor resulted in a return code that is greater than the maximum acceptable
return code for that step in the processor definition. CA-Endevor set a "processor
failed flag."
To Fix: Examine the processor output and messages to determine the cause of the
error. Correct the error condition and resubmit the request.
SE Workflow Document Common Errors and their Solutions
EM16: C1G0129E
ERROR MESSAGE :
STEP LINK RC (0008) EXCEEDS THE MAX RC (0004) FOR THE
PROCESSOR STEP
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT?
Sol:
Cause: The Link step in a processor resulted in a return code (RC 0008) is greater
than the maximum acceptable return code ( RC 0004) in the processor definition.
CA-Endevor set a "processor failed flag."
To Fix: Examine the processor output and messages to determine the cause of the
error. Correct the error conditions and resubmit the request.
EM17. SMGR006E
ERROR MESSAGE :
ERROR READING DELTA MEMBER - EXPECTED DELTA CONTROL
RECORD – BADCNTL
WHY THIS MESSAGE IS ISSUED AND HOW DO YOU FIX IT ?
Sol:
Cause: Internal error.
To Fix: Contact CA-Endevor Technical Support.
SE Workflow Document Frequently Asked Questions
Q3. Are the level number assigned to component list are the same as of the level number
of elements?
Sol. The level numbers assigned to a component list (component levels) are independent
of the level numbers assigned to an element (element levels). Since an element may be
recompiled many times due to copy or macro changes, there may be more component
levels than element levels. In addition, monitoring may be initiated at any time and at
any element level.
SE Workflow Document Appendix
11 Appendix
11.1 Definitions
Root:
The base program with which programmers are working. Derivation 1 and Derivation 2
files are derived from this program. y
Derivation 1:
A modified copy of the Root
Derivation 2:
Another modified copy of the Root.
Work-In-Process (WIP):
The file built when CA-PDM compares the Root and one or two Derivations. The WIP
File is an annotated intermediate file that identifies the insertions and deletions made
individually by the Derivations, as well as the insertions and deletions common to both.
Potential insert conflicts are also identified.
Merge output file:
An output file created by CA-PDM using the WIP File as input. When the Merge Output
File is created, the annotations from the WIP File are removed, and all insertions and
deletions are performed.
990108 means that the package cannot be executed until January 8, 1999, and the
remaining characters describe the package.
Subsystem : RCM
Type : PROC
Element : RCMAELIT
Libraries to verify: PGMBR.ALLCM.HOLD.PROC
PGMBR.ALLCM.TEST.PROC
MOVE TO PROD
Description : Move element from HOLD to PROD
System : GMBR
Subsystem : RCM
Type : PROC
Element : RCMAELIT
Libraries to verify: PGMBR.ALLCM.PROD.PROC
PGMBR.ALLCM.HOLD.PROC
RERIEVE ( In emergency mode)
Description : Retrieve an element from PROD
System : GMBR
Subsystem : RCM
Type : PROC
Element : RCMAELIT
Libraries to verify: WZWDW8.PDS.LIB
EDIT ( In emergency mode)
Description : Make changes as required
System : GMBR
Subsystem : RCM
Type : PROC
Element : RCMAELIT
Libraries to verify: WZWDW8.PDS.LIB
ADD TO FIX ( In emergency mode)
Description : Add element to FIX
System : GMBR
Subsystem : RCM
Type : PROC
Element : RCMAELIT
Libraries to verify: PGMBR.ALLCM.FIX.PROC
WZWDW8.PDS.LIB
MOVE TO PROD ( In emergency mode)
Description : MOVE element from FIX to PROD
System : GMBR
Subsystem : RCM
Type : PROC
Element : RCMAELIT
Libraries to verify: PGMBR.ALLCM.PROD.PROC
PGMBR.ALLCM.FIX.PROC
DELETE
Description : DELETE element from PROD
System : GMBR
SE Workflow Document Appendix
Subsystem : RCM
Type : PROC
Element : RCMAELIT
Libraries to verify: PGMBR.ALLCM.DELE.PROC
PGMBR.ALLCM.PROD.PROC