The NEW Endevor

AHOLD Stop & Shop

JUNE 2006
2
Life Cycle at AHOLD
TST PRD
TEST SYST QAST PROD
FIX
FIXX EXEC
MOVE MOVE
RETRIEVE
MOVE(PKG ONLY)
ADD
USER
NDVR
SRC
T
S Q P
F E
3
Inventory Mgmt - STOP &
SHOP
NDBA
NFINANCE
NMACRM
NPAYROLL
CPY
MAC
CBL
ASM
CBO
STD
STD1

PGMA
CPYDATE
SYSTEMS
TYPES
SUBSYSTEMS
ELEMENTS
ENVIRONMENT = TST
CCID = IDENTIFIER OF A
PROJECT /PROBLEM TICKET
AND ALSO USED
FOR TRACKING
EZT
PRC
SCH
JOB
... etc
NPOS
NMERCH
NECOMM
NDINVMGTetc
NEFT
NLBTMGT
NMKTING
NCATMAN
4
Sample Types
TYPE TYPE
DESCRIPTION

REX REXX EXECS
OPT COMPILER OPTIONS
LNK LINK PARMS
CPY COPYBOOKS AND ++INCLUDES
MAC ASSEMBLER MACRO
IMS DBA IMS COPYBOOKS ONLY(.IMS)
PSB DL1 PSB
DCL DB2 DCLGEN COPYBOOK
LOD BATCH LOAD MODULE ONLY; NO SRC
KOM PME JOBSETS
FOR FORTRAN SOURCE
MAP ASSEMBLER MAPS
AXN AION SUBROUTINES - NO START
CXL COBOL BATCH SUBROUTINES
AON AION KNOWLEDGE BASE
EZT EASYTREV SOURCE CODE
ASM ASSEMBLER BATCH PGMS
ASO ASSEMBLER ONLINE PGMS
TYPE TYPE DESCRIPTION

CBT COBOL SOURCE FOR TELON
CBL COBOL BATCH PGMS
CBO COBOL ONLINE PGMS
PR1 CONTROL CARDS
PR2 CURRENTLY KBMSPARMS
PRC JCL PROCEDURES
JOB JOB CONTROL LANGUAGE
DOC DOCUMENTATION
ISM ISPDTLC MESSAGES
ISP ISPDTLC PANELS
IST ISPDTLC TABLES
SCH PRDCTL SCHEDULE CHANGES
RPT PRDCTL REPORT CHANGES
SDM SYSD MESSAGES
SDP SYSD PANELS
SDS SYSD SKELETON
MFS MFS CODE


5
Processor Group Naming
Standards
First 3 Characters = Language Type
ASM=ASM CII=Cob II CLE=Cobol LE COS=Cobol os/390
Fourth Character = Database
N=None D=DB2
Fifth Character = CICS?
B=Batch C=CICS N=None M=Map I=IMS
Sixth Character =
L=Link O=Object Only D=DL/1
Seventh Character =
X=XI Macros K=KBMS M=Telon Map Source
Eighth Character =
T = Telon
6
Sample Processor Group
Selection Panel

--------------------- PROCESSOR GROUP SELECTION LIST ------- Row 1 to 5 of 5
COMMAND ===> SCROLL ===> PAGE

CURRENT ENV: TST STAGE ID: T SYSTEM: NPOS TYPE: CBO
NEXT ENV: TST STAGE ID: S SYSTEM: NPOS TYPE: CBO

PROCESSOR
GROUP PROCESSOR GROUP DESCRIPTION
DB2 CICS
COSDCL00 COB OS/390 DB2 CICS
COSDILX0 COB OS/390 IMS/DC - XI MACROS
COSNCD00 COB OS/390 CICS - DL/1 CALLS
COSNCLMT COB OS/390 TELON CICS - BMS MAP
COSNCL0T COB OS/390 TELON CICS
COSNCL00 COB OS/390 CICS
COSNID0T COB OS/390 TELON IMS/DC - DL/1 CALLS
COSNILX0 COB OS/390 IMS/DC - XI MACROS
NODFAULT ** NO VALID PROCESSOR GROUP ****
7
Application Specific Library Naming
Standards
First node: SP
Second node: NDV
Third node: 2 Chars (first char represents Operating Company, second
character represents Stage id)
ie NT Stop & Shop Test Stage (first stage of TST Environment)
NF Stop & Shop Fix Stage (first stage of FIX Env)
Fourth Node STD (Subsystem)
Fifth node: Output LIBRARY Type (i.e. one of the following - partial list)
LINKLIB.BATCH A library which contains BATCH load modules
LINKLIB.CICS A library which contains ONLINE load modules
LINKLIB.IMS A library which contains IMS/DC load modules
PARMLIB1 Library which contains parms for stages T,S,Q,F, and E**
LISTLIB A library which contains source listings
OR: If this is an Endevor BASE library (i.e. see below - partial list)
ENDEVOR TYPE (3 characters)
CPY Copybooks
SRC Program source (ASM, CBL, EZT, etc)
**EXCEPTION : The Production Stage (Env PRD; Stage P), type PR1 (parms), the
output library will be PROD.CARDLIB

For preparation of PRO/JCL, should use Nx.APL.JOBLIB and Nx.APL.PROCLIB where x is
stage character

8
DataSet Mapping
GO TO NEXT SLIDE
SP.NDV.NT.STD.CPY (or .IMS)
SP.NDV.NT.STD.SRC
SP.NDV.NT.STD.LINKLIB.BATCH
SP.NDV.NT.STD.LINKLIB.CICS
SP.NDV.NT.STD.LINKLIB.IMS
SP.NDV.NT.STD.DSECT (map
cpybks)
NT.APL.ABENDAID.SOURCE
SP.NDV.NT.STD.JOB/PRC
NT.APL.JOBLIB/PROCLIB
SP.NDV.NT.STD.PR1
SP.NDV.NT.STD.PARMLIB1
SP.NDV.NT.STD.KOMLIB
SP.NDV.NT.STD.DBRM
SP.NDV.NT.SMS.SYSD.MESSAGE
SP.NDV.NT.SMS.SYSD.PANEL
SP.NDV.NT.SMS.SYS.SKELETON
SP.NDV.NT.STD.PSB
SP.NDV.NT.STD.PSBLIB/ACBLIB
SP.NDV.NT.STD.LISTLIB
SP.NDV.NS.STD.CPY (or .IMS)
SP.NDV.NS.STD.SRC
SP.NDV.NS.STD.LINKLIB.BATCH
SP.NDV.NS.STD.LINKLIB.CICS
SP.NDV.NS.STD.LINKLIB.IMS
SP.NDV.NS.STD.DSECT (map
cpybks)
NS.APL.ABENDAID.SOURCE
SP.NDV.NS.STD.JOB/PRC
NS.APL.JOBLIB/PROCLIB
SP.NDV.NS.STD.PR1
SP.NDV.NS.STD.PARMLIB1
SP.NDV.NS.STD.KOMLIB
SP.NDV.NS.STD.DBRM
SP.NDV.NS.SMS.SYSD.MESSAGE
SP.NDV.NS.SMS.SYSD.PANEL
SP.NDV.NS.SMS.SYS.SKELETON
SP.NDV.NS.STD.PSB
SP.NDV.NS.STD.PSBLIB/ACBLIB
SP.NDV.NS.STD.LISTLIB
TST
T
S
9
DataSet Mapping
SP.NDV.NQ.STD.CPY (or .IMS)
SP.NDV.NQ.STD.SRC
SP.NDV.NQ.STD.LINKLIB.BATCH
SP.NDV.NQ.STD.LINKLIB.CICS
SP.NDV.NQ.STD.LINKLIB.IMS
SP.NDV.NQ.STD.DSECT (map
cpybks)
NQ.APL.ABENDAID.SOURCE
SP.NDV.NQ.STD.JOB/PRC
NQ.APL.JOBLIB/PROCLIB
SP.NDV.NQ.STD.PR1
SP.NDV.NQ.STD.PARMLIB1
SP.NDV.NQ.STD.KOMLIB
SP.NDV.NQ.STD.DBRM
SP.NDV.NQ.SMS.SYSD.MESSAGE
SP.NDV.NQ.SMS.SYSD.PANEL
SP.NDV.NQ.SMS.SYS.SKELETON
SP.NDV.NQ.STD.PSB
SP.NDV.NQ.STD.PSBLIB/ACBLIB
SP.NDV.NQ.STD.LISTLIB
SP.NDV.NP.STD.CPY (or .IMS)
SP.NDV.NP.STD.SRC
SP.NDV.NP.STD.LINKLIB.BATCH
SP.NDV.NP.STD.LINKLIB.CICS
SP.NDV.NP.STD.LINKLIB.IMS
SP.NDV.NP.STD.LINKLIB.IMS.LE
SP.NDV.NP.STD.DSECT (map cpybks)
NP.APL.ABENDAID.SOURCE
SP.NDV.NP.STD.JOB/PRC
NP.APL.JOBLIB/PROCLIB
SP.NDV.NP.STD.PR1
PROD.CARDLIB (not changed due to references
in existing procs)
SP.NDV.NP.STD.KOMLIB
SP.NDV.NP.STD.DBRM
SP.NDV.NP.SMS.SYSD.MESSAGE
SP.NDV.NP.SMS.SYSD.PANEL
SP.NDV.NP.SMS.SYS.SKELETON
SP.NDV.NP.STD.PSB
SP.NDV.NP.STD.PSBLIB/ACBLIB
SP.NDV.NP.STD.LISTLIB
PRD
Q
P
Package Move Only
10
DataSet Mapping
SP.NDV.NF.STD.CPY (or .IMS)
SP.NDV.NF.STD.SRC
SP.NDV.NF.STD.LINKLIB.BATCH
SP.NDV.NF.STD.LINKLIB.CICS
SP.NDV.NF.STD.LINKLIB.IMS
SP.NDV.NF.STD.DSECT (map
cpybks)
NT.APL.ABENDAID.SOURCE
SP.NDV.NF.STD.JOB/PRC
(none)
SP.NDV.NF.STD.PR1
SP.NDV.NF.STD.PARMLIB1
SP.NDV.NF.STD.KOMLIB
SP.NDV.NF.STD.DBRM
SP.NDV.NF.STD.PSB
SP.NDV.NF.STD.PSBLIB/ACBLIB

SP.NDV.NE.STD.CPY (or .IMS)
SP.NDV.NE.STD.SRC
SP.NDV.NE.STD.LINKLIB.BATCH
SP.NDV.NE.STD.LINKLIB.CICS
SP.NDV.NE.STD.LINKLIB.IMS
SP.NDV.NE.STD.DSECT (map cpybks)
NT.APL.ABENDAID.SOURCE
SP.NDV.NE.STD.JOB/PRC
NE.APL.JOBLIB/PROCLIB
SP.NDV.NE.STD.PR1
SP.NDV.NE.STD.PARMLIB1
SP.NDV.NE.STD.KOMLIB
SP.NDV.NE.STD.DBRM
SP.NDV.NE.STD.PSB
SP.NDV.NE.STD.PSBLIB/ACBLIB

FIX
F
E
Special CCID Only
11
Clist Summary - Entered from
ISPF/Primary Options Menu
NDVR -- Get Operating Company Screen and Then go
into Endevor/MVS
TSO QE -- Get Operating Company Screen and then go
into Endevor Quick Edit (mostly used for emergency fixes)
TSO PDM -- Get Operating Company Screen and then go
into Parallel Development Manager (for source
compares/merges)
TSO NDVRESET -- Used when you DONT get
Operating Company Screen
TSO FLST -- Get Operating Company Screen and then go
into Fastlist (programmer workbench)
12
GETTING STARTED
Enter option NDVR on the ISPF/PDF Primary Option Menu. OR
Enter option TSO FLIST on the ISPF/PDF Primary Option Menu
Next you will get a panel shown below (NOTE: If you do not, PF3 back to ISPF/PDF and enter TSO
NDVRESET) then enter NDVR or TSO FLST again
Enter Your Operating Company, ie N for Stop & Shop

Production Change System / ENDEVOR Date: 02/02/20
02.051
Company Selection Menu Time: 20:11
System: AMVS
COMMAND ===>

Company........ ===> N <==== Enter N here


N - Stop & Shop
ET - Endevor Training
EA - Administration


Press ENTER to continue Press END to cancel
13
Choose an Environment

Next choose option 1 (TST) on panel below.


------------------- Endevor for OS/390 Environment Selection - Row 1 to 5 of 5
Option ===> Scroll ===> PAGE

Select an environment to continue. Enter the END command to exit.
-- -------- ----------------------------------------
1 TST STOP AND SHOP TEST ENVIRONMENT
2 FIX STOP AND SHOP FIX ENVIRONMENT
3 PRD STOP AND SHOP PROD ENVIRONMENT

******************************* Bottom of data ********************************


14
CCID Procedure
Developers will now be responsible to create their OWN Endevor CCIDs. These are the CCIDs
that are associated with a service request, change request, or to make a permanent solution
to a valid production problem.

This process will NO longer be handled through the Software Configuration
Management/Endevor team via a change request. This new procedure should benefit the
developers as it eliminates paperwork, puts control of the CCID usage under their
responsibility, and eliminates the middle man.

Developers now will invoke a CLIST called "CRE8CCID". Specify TSO CRE8CCID at the option
prompt and you will be prompted with a panel and need to enter the appropriate information
(system, subsystem, etc.).
NOTE: This "logs in your request". The actual updating of the Endevor CCID table will occur
via a sweep job running every half hour starting @ 8:00am and ending at 4:30 PM Monday
- Friday only!! At this point your CCID will be activated and available for your use.
This CLIST does NOT validate the CCIDs against your service requests, change requests, or
problem tickets....therefore if you enter an incorrect number please do NOT call us (smile).

This new process/procedure does NOT apply to using the FIX Environment. This CCID will
continue to be provided via the helpdesk to users with a valid Production problem.
15
Procedures for Type SCH
A Schedule change requires you to fill out a form and
process it through Endevor
The blank form or (master) can be Retrieved from Endevor (use
signout = No) to your PDS
Env = PRD
Sys = oXYZ whereby o is your operating company
Type = SCH
Element = SCHEDULE
16
Procedures for Type SCH
Next you need to Fill out the form and add it back into
Endevor.
The Form should be added to the SAME Endevor inventory that
applies to your schedule or report (NOT oXYZ)
For example:
--------------------------- ELEMENT SELECTION LIST -------
COMMAND ===> SCROLL ===> PAGE

ELEMENT TYPE ENVIRON S SYSTEM SUBSYSTEM
GPRABPA4 SCH T ST P NPOS STD
GPRADLA0 SCH TST P NPOS STD
SCHE001 SCH TST P NMERCH STD
GPHRS119 SCH TST P NDPROCUR STD

17
Procedures for Type SCH
Since you are processing a SCH type, your package name
will have a special 3rd character
Package NPX.. where:
first char = Operating Company
second char = target of move (P for PRD)
third char =
S ----- if pkg contains type SCH
X ---- if pkg contains types other than listed above
NOTE: You can use either an S if you have both SCH types and
other types in the same package.
18
Easytrieve Handling
CURRENT ENV: TST STAGE ID: T SYSTEM: NMASTER TYPE: EZT
NEXT ENV: TST STAGE ID: S SYSTEM: NMASTER TYPE: EZT

PROCESSOR
GROUP PROCESSOR GROUP DESCRIPTION
EZTDBL00 EASYTREV - DB2 COMPILE AND LINK
EZTNBL00 EASYTREV - COMPILE AND LINK

Your current run and go easytrieve source is executed via your
jcl pointing to PROD.CARDLIB.so our only choice is to load into
type PR1.

Duplicates however between your current easytrieve type and CARDLIB
will need to be identified and decision made which source is truly
current.


19
Stop & Shop - Package Naming
Standards
Package NPXuseridabcdef1 where characters 1 thru 3 are a
production control standard:
first character = Operating Company (ie N for Stop & Shop)
second character = Target Stage (usually P)
third character =
S ----- if pkg contains type SCH
X ---- if pkg contains types other than listed above
The next 4-16 characters are suggestions (optional) but remember
package name must be unique.
fourth thru eighth char = tso userid
additional characters can represent = CCID, Date, Project,
Application, etc (and last char is an incremental so pkg name
is unique)
20
Package Standards

Automatic Submission (Package in APPROVED
Status)
Monday-Friday @ 4:00 AM, 9:00 AM, 9:00 PM
REQUIRED for any PACKAGES where elements
are being moved into PRODUCTION (STAGE P)
FIX Environment
Package NOT REQUIRED (automatic archive of elements
done in 2-3 business days)
21
Review Option used by Approvers to
Review/Deny a Package
---------------------- Package Foreground Options Menu ---------------
Option ===> 4

1 DISPLAY - Display Package Information
2 CREATE/MODIFY - Create or Modify Package
3 CAST - Prepare Package for Review
4 REVIEW - Approve or Deny Package
5 EXECUTE - Submit or Execute Package
6 SHIP - Ship Packages
7 BACKOUT - Perform Backout or Backin Processing
8 COMMIT - Clear Backout Information
9 UTILITIES - Reset, Delete, or Export Package
L DistribuLink - Perform Product Collection Request

Package ID ===> NPXUSERIDabcdef1

Limit selection list by Package Status. These are used by the DISPLAY
and UTILITIES options:

In-Edit......... Y In-Execution.... Y
In-Approval..... Y Executed........ Y
Denied.......... Y Committed....... Y
Approved........ Y
22
Display, Approve or Deny
REVIEW ----------------------- REVIEW PACKAGE ---------------------------------
OPTION ===>

blank - Display Action Summary D - Deny Package
A - Approve Package L - Display Approver Groups
N - Add Notes to Package DA Dynamic Approvers


PACKAGE ID: NPXUSERIDabcdef1 STATUS: IN-APPROVAL
DESCRIPTION: MODIFY RULES FOR LOCAL 464A
PACKAGE TYPE: STANDARD
SHARABLE PACKAGE: Y
EXECUTION WINDOW FROM: 09APR01 00:00 TO: 31DEC79 00:00

User Id Date Time
CREATED: NVSEC1 09APR01 13:57
LAST UPDATED: NVSEC1 09APR01 14:00
CAST: NVSEC1 09APR01 14:01
DENIED:



23
Display of Package Approver
Groups
DISPLAY ------------------ PACKAGE APPROVER GROUPS -------- Row 1 to 6 of 6
COMMAND ===> SCROLL ===> CSR

S - Select Approver Group

PACKAGE ID: NPXUSERIDabcdef1 STATUS: IN-APPROVAL
DESCRIPTION: MODIFY RULES FOR LOCAL 464A
PACKAGE TYPE: STANDARD

* indicates externally defined approvers
See 'SP.NDV.AMVS.RACF.APPROVER.GROUPS' for TSO Userid's in the external group

APPROVER APPROVAL NUMBER OF NUMBER NUMBER
ENVIRONMENT GROUP STATUS QUORUM APPROVERS APPROVED DENIED
PRD * NNXQA 1 EXTNL 1 0
PRD * SFNDVADM APPROVED 0 EXTNL 0 0
PRD * SNXAIS APPROVED 0 EXTNL 0 0
PRD * SNXHLPDK APPROVED 0 EXTNL 0 0
PRD * SNXOTA APPROVED 0 EXTNL 0 0
PRD * SNXPRDCT 1 EXTNL 1 0
******************************* Bottom of data ********************************
24
Approve - Choose Option A
REVIEW ----------------------- REVIEW PACKAGE ---------------------------------
OPTION ===> A

blank - Display Action Summary D - Deny Package
A - Approve Package L - Display Approver Groups
N - Add Notes to Package DA Dynamic Approvers


PACKAGE ID: NPXUSERIDabcdef1 STATUS: IN-APPROVAL
DESCRIPTION: MODIFY RULES FOR LOCAL 464A
PACKAGE TYPE: STANDARD
SHARABLE PACKAGE: Y
EXECUTION WINDOW FROM: 09APR01 00:00 TO: 31DEC79 00:00

User Id Date Time
CREATED: NVSEC1 09APR01 13:57
LAST UPDATED: NVSEC1 09APR01 14:00
CAST: NVSEC1 09APR01 14:01
DENIED:

Note: Option DA dynamic approvers, provides package approvers the ability to add
additional approvers to a package while it is in the in-approval state.



25
Approval Performed
---------------------- Package Foreground Options Menu ----,APPROVAL PERFORMED
Option ===>

1 DISPLAY - Display Package Information
2 CREATE/MODIFY - Create or Modify Package
3 CAST - Prepare Package for Review
4 REVIEW - Approve or Deny Package
5 EXECUTE - Submit or Execute Package
6 SHIP - Ship Packages
7 BACKOUT - Perform Backout or Backin Processing
8 COMMIT - Clear Backout Information
9 UTILITIES - Reset, Delete, or Export Package
L DistribuLink - Perform Product Collection Request

Package ID ===> NPXUSERIDabcdef1

Limit selection list by Package Status. These are used by the DISPLAY
and UTILITIES options:

In-Edit......... Y In-Execution.... Y
In-Approval..... Y Executed........ Y
Denied.......... Y Committed....... Y
Approved........ Y
26
Hints, Gotchas and Tidbits
If a user after typing either NDVR, TSO QE, TSO FLST or TSO PDM and does
NOT get the operating company selection panel, then they need to exit out and type at
the command prompt TSO NDVRESET
ALSO TSO NDVRESET should be used if you encounter strange errors such as FTOPEN
error using Quick Edit, ASAINI not found when using Endevor Batch, or you just bomb out of
Endevor for some reasonjust exit back to tso and type tso ndvreset which cleans up your
storage.
Under the New Endevor, your load libraries have been separated into
SP.NDV.Nx.STD.LINKLIB.BATCH
SP.NDV.Nx.STD.LINKLIB.CICS (this used to be part of your batch)
SP.NDV.Nx.STD.LINKLIB.IMS
THERE WILL BE NO MORE MOVES FROM FIRECALL (FIX Stage 2)
DIRECTLY TO PRODUCTION ! ! ! !
When creating a package, limit number of SCL actions per package. Suggested number
is 25-30 programs per package. Reason is so you will not exceed number of dynamic
allocations, storage, space and manageable restart in case of a failure.
27
Hints, Gotchas and Tidbits
(continued)
Remember for a NEW element, you must enter an * (asterisk) in the processor group
field in order to select the appropriate processor group (ie proc to use to
compile/link).Otherwise you will get a RC of 16 indicating to do so.
Reminder:
Cobol copybooks - Type CPY
Assembler macros - Type MAC
Program listings go to the SDSF queue for every stage except Q and P.
Program listings are stored in every stage except in the Fix environment (stages F and
E) ie SP.NDV.Nx.STD.LISTLIB. They are of course deleted once element moves
through that stage.
Please DO NOT pass parms in CBL statements at the top of your cobol source. For
auditing purposes, please create an element override OPT type instead. Thank you for
your cooperation.
Cobol LE/MVS compiler uses as a default DYNAM which is different from your
previous compilers. This will result in subroutines to be resolved at run time instead of
linkedit timehence you will no longer get a cast error indicating you forgot to move a
subroutine.


28
Hints, Gotchas and Tidbits
(continued)
Old Endevor type CICSMAP now goes to type MAP. In addition, the dsect is now
written to its own library (SP.NDV.Nx.STD.DSECT) instead of to the copylib.
All program source can now be searched OUTSIDE of Endevor if you choose. Dataset
to do a TSO 3.14 search against is SP.NDV.Nx.STD.SRCwhere x is stage
character.
BE CAUTIOUS: The new Endevor FIX Environment is stages F and Ethe REVERSE
of your FIRECALL environment.
To aid looking at program listing, do a find for binder to position yourself at the output
from the linkage editor.
The New Endevor will NOT automatically have SYST.ENDEVOR.SCL filled in on
your batch panel (what ever you enter will be kept for you).
The New Endevor will also NOT have on the Retrieve panel the field asking you to
signout element to be set to Y or N. AHOLDs default is always Y.
The New Endevor now requires CCID and COMMENT mandatory.


29
DISPLAY ELEMENTS
------------------- Display Elements/Component Lists ------------------------
OPTION ===>

blank - Display selection list B - Browse element current level
S - Display summary of levels C - Display changes current level
M - Display element master info H - Display history current level

Enter SX, BX, CX or HX to display component list information

LIST OPTIONS:
FROM ENDEVOR: DISPLAY PROC GRP NAME ===> Y (Y/N)
ENVIRONMENT ===> TST DISPLAY LIST ===> Y (Y/N)
SYSTEM ===> e* WHERE CCID EQ ===>
SUBSYSTEM ===> WHERE PROC GRP EQ ===>
ELEMENT ===> DISPLAY SYS/SBS LIST ===> N (Y/N)
TYPE ===> cbl BUILD USING MAP ===> y (Y/N)
STAGE ===> t T - TEST S - SYST
30
Element Selection List


--------------------------- ELEMENT SELECTION LIST --------- Row 1 to 8 of 8
COMMAND ===> SCROLL ===> CSR

CURRENT PROCESSOR
ELEMENT TYPE ENVIRON S SYSTEM SUBSYSTEM VV.LL DATE GROUP
LOADRDAT CBL TST T ETRAIN STD 01.05 22JUN00 COSNBL00
M3XAUD CBL PRD Q ETRAIN STD 01.02 16NOV99 COSNBL00
M3XAUD CBL PRD P ETRAIN STD 01.01 16NOV99 COSNBL00
M3XCNVA CBL PRD P ETRAIN STD 01.00 20MAR98 COSNBL00
M3XDNR CBL PRD Q ETRAIN STD 01.01 25MAY00 COSNBL00
M3XDNR CBL PRD P ETRAIN STD 01.00 20MAR98 COSNBL00
M3XQRY CBL PRD P ETRAIN STD 01.00 20MAR98 COSNBL00
M3XSEC CBL PRD P ETRAIN STD 01.00 20MAR98 COSNBL00
******************************* Bottom of data ********************************
31
Delete action is NOT allowed in Production
Stage
The user should use the ARCHIVE (option 13) action instead. This action will
FIRST copy the element to an archive dataset followed by a delete.
The ARCHIVE action can only be executed in a PACKAGE (for PRD Env Stage
P) or via Batch for Fix Environment Stage E. Archive CANNOT be executed
in Quick Edit (TSO QE). Make sure the Delete from element flag is set to a
Y or the element will not get deleted from production.
The syntax for an Archive action is as follows:
ARCHIVE ELEMENT 'XXXXXXXX'
FROM ENVIRONMENT 'EEE' SYSTEM 'SSSSSSSS' SUBSYSTEM 'YYYY'
TYPE 'TTT' STAGE NUMER 2
TO DDNAME ARCHFILE
OPTIONS CCID 'CCCCCCCC' COMMENTS "ARCHIVE ELEMENT"
.


32
Delete action is NOT allowed in Production
Stage (continued)
where EEE is your environment name (PRD or FIX)
XXXXXXXX is your element name
SSSSSSSS is your system name
YYYY is your subsystem name
TTT is your type name
CCCCCCCC is your ccid
(Remember to have a period (.) at the end of your statement)
NOTE: The package has to be submitted thru the automated package job
that runs 3 times a day on CNTL-M
You can DELETE from stage E by using the special delete ccid
FIXEDELETE. This is the only ccid that can be used with the delete action
in stage E.
If you have any questions, feel free to contact your Endevor Administrator.
33
OPTNDRVR
Program that passes parm cards to compilers
Precompiler
Compiler
Linkage editor
Post processors
Eliminates need for many Processor Groups
User can specify appropriate parm overrides instead of
being hardcoded in processor/processor groups
OPTNDRVR reads in 4 pds members and 4 search keys
34
OPTNDRVR Components
OPTNDRVR Processor Components:

//GETOPTNS EXEC PGM=OPTNDRVR,COND=(0,LT),MAXRC=0,
// PARM=('&GLOBOPTN,&DFLTOPTN,&C1ELEMENT,&FORCOPTN',
// '&OPTN1,&OPTN2,&OPTN3,&OPTN4')

&GLOBOPTN Name of member for AHOLD global
override options (I.e.System=NXYZ,Type=OPT,
Element=NGCLENB)
&DFLTOPTN Name of member for applications/system default
override options (I.e.System=NXYZ,Type=OPT,
Element=NDCLENB)
&C1ELEMENT Element name used for element level overrides
(I.e.System=NDMERCH,Type=OPT,Element=elename)
&FORCOPTN Name of options member to force override
previous options, whereby enforcing standards
in parms (I.e.System=NXYZ,Type=OPT,Element=NFCLENB)
&OPTNx Search keys point to desired records in a
member
35
Sample System Override at
Processor Group Level
Sample of System default option member for Cobol COS. Following
are the most used parms.

+00 **********************************************************************
+00 ** D E F A U L T O P T I O N S COBOL OS/390 BATCH
+00 ** POSITION 1 MUST BE BLANK
+00 ** POSITION 2 - 9 STEP DESCRIPTION
+00 ** POSITION 10 - 11 BLANK
+00 ** POSITION 12 - 72 OPTIONS - LAST POSITION MUST BE A COMMA
+00 **********************************************************************
+00 COS DATA(24),NOADV,LIST,RENT,
+00 LINK LET,LIST,MAP,XREF,NORENT,

Stored in Endevor as member NDCOSNB for System NXYZ Type
OPT in Env PRD by administrator

36
Sample Element Override OPT
member
User needs to do an element override for a cobol batch program that
he will be adding to endevor. The default (system OPT member) or the
INSTALLATION defaults has wrong linkage editor attributes and/or
compiler needs NODYN. So BEFORE he can add the cobol pgm, the
user will first create an Element override option member. USER
MUST FOLLOW FORMAT RULES BELOW. NOTE: COMMA
IS NEEDED AFTER LAST PARM.
COMMENT IND 1 (* - DENOTES A COMMENT)
COMPILER NAME 2 -> 9 (COMPILER NAME OR SEARCH KEY)
BLANK 10,11 (WILL BE IGNORED)
PARMS 12 -> 72 (DELIMITED BY COMMAS)
NOT-USED 73 -> 80 (WILL BE IGNORED)
12345678901234567890.....................5678901234567890
* Element Parm override needed For Cobol Batch
COS NODYNAM,
LINK AMODE=24,RMODE=24,

37
Endevor Steps
Next User ADDs element override member to Endevor (ENV=TST,
SYS=system, TYPE=OPT, ELEMENT=same as cobol pgm that needs
the override, STAGE=T), ie TST, NDMERCH, OPT, PROGA
Now user can ADD his cobol program to Endevor (ENV=TST,
SYS=system, TYPE=CBL, ELEMENT=cobol pgm,STAGE=T) which
will now result in the endevor processor to use the element override
linkage editor attributes and compiler override
After testing cobol pgm successfully, user now must MOVE BOTH
the cobol pgm and the option member up the map
MOVE ELEMENT 'CDAPEDIT' FROM ENVIRONMENT 'TST' SYSTEM system SUBSYSTEM
'STD' TYPE 'CBL' STAGE T OPTIONS COMMENTS "MOVE TO NEXT STAGE" .
MOVE ELEMENT 'CDAPEDIT' FROM ENVIRONMENT 'TST' SYSTEM system' SUBSYSTEM
'STD' TYPE 'OPT' STAGE T OPTIONS COMMENTS "MOVE TO NEXT STAGE" .
(NOTE: Type sequencing will result in the OPT member be
processed before the CBL member)
38
Misc Info Regarding Options
User DOES NOT Need to ever RETRIEVE and RE-ADD the OPT
element override again UNLESS the override options need to be
changed.
The next remediation of the program will pick up the corresponding
Element override OPT Production version.
Element option Overrides can specify just precompiler, compiler,
linkage editor or any combination.
A browse of the cobol program component list (BX), will show the
option members it used.
STEP: GETOPTNS DD=CMPARMS VOL=SS5SE0 DSN=SP.NDV.NP.STD.OPT

MEMBER VV.LL DATE TIME SYSTEM SUBSYS ELEMENT TYPE STG
+00 NDCOSNB 01.03 13OCT98 11:38 NXYZ STD NDCOSNB OPT 2
+00 NFCOSNB 01.02 18JUN98 08:38 NXYZ STD NFCOSNB OPT 2
+00 MGCOSNB 01.03 18JUN98 08:38 NXYZ STD NGCOSNB OPT 2
+00 PROGA 01.03 18JAN02 08:38 NDMERCH STD PROGA OPT 2
39
Endevor Maintenance
Enhancements
ESORT COMMAND FOR SORTING ENDEVOR ISPF SELECTION LISTS
The ESORT (abbreviated ES) command can be used to sort any Endevor selection list by
column. To sort a list, type ES column heading on the ISPF command line. Column heading
is the name appearing at the top of the column. If you would like to sort the list in descending
sequence, prepend the column heading name with a -.
EXAMPLE: ES GENERATE sorts the Display Element selection list by generate date.
ES TYPE sorts the Display Element selection list by type
ES VV.LL sorts the selection list by version and level in descending sequence
ES sorts the selection list in the default sequence

OMITTED PACKAGE ID AND ELEMENT PROMPT OPTION
If the package is omitted and the enter key is hit OR if the element name is omitted with
build Using Map set to Y, then Endevor will display a confirmation panel.
NOW you wont say DARN, I hit enter by mistake, and wait forever until the display comes back ! ! !

GENERATE-IN-PLACE QUICK-EDIT OPTION
There is now an option (go to Quick-Edit Action Options) to specify the element is to be
generated at the location where it currently resides.
If this option is not specified, the element will be copied back to the first stage of the
environment specified on the Quick-Edit panel and then Generated.


40
Endevor Maintenance
Enhancements

PACKAGE FUNCTIONS NOW IN QUICK EDIT
With Release 3.7.2, a user had to EXIT out of Quick Edit and go to Endevor to perform package functions
(DISPLAY, CREATE/MODIFY, CAST, APPROVE, etc).
A user now can remain in Quick Edit and choose option "P Package Options" and the next panel the user will see is
the Package Foreground Options Menu. (This is the same panel that the user gets when choosing option "4 Package"
from the Endevor Primary Options Panel). User then performs package options as before.

PROCESSOR GROUP NAME ON ISPF ELEMENT SELECTION LIST
An additional list option has been added to the Display Element/Component List Panel. DISPLAY PROC GROUP
NAME whereby we set the default to Y. This causes the processor group name associated with an element to be
displayed on the element selection list. NOW at a GLANCE, you can see what elements are still using COBOL VS
(i.e. COBNBL00).

MISCELLANOUS
A browse of the component list for an element will now display in the Output Component Section the name of the
listlib that we wrote to.
Uunder TSO QE (Quick Edit), build using map = N now shows both stages for that environment. Under the prior
release, it would only show the first stage of that environment.


41
Endevor Maintenance
Enhancements

PACKAGE APPROVER ENHANCEMENTS
With Release 3.7.2, approver groups (i.e. PROD/CTL) were limited to only 16 TSO userids per approver group. This
restriction sometimes resulted in groups deciding which userids to remove in order to put an additional person in a
group that was at this limit. Approver group definitions are now defined EXTERNALLY to RACF, thus eliminating
the 16 userid limit.
HOW THIS ENHANCEMENT AFFECTS YOU: At Package CAST time, approver groups will be associated to the
package (just as before). The naming standard of the approver group has been changed to represent an EXTERNAL
RACF group. For example,
XBILLING/APP changed to XNXBILL
XCYBORG/APP changed to XNXCYB
BILO/APP changed to BNXBILO
ASC/APP changed to XNABIC, XNABILL, XNACYB, and XNATRIL
Where: 1
st
character is Operating Company, 2
nd
character is N for Endevor, 3
rd
character is Subsystem (X for all
subsystems, A for ASTD, etc), and 4
th
through 8
th
characters represents System/Application.

Just as before only an approver can approve/deny, execute, reset, etc a package. NOTE: With external approver group
definitions however you can not display the userid's of who is in this approver group. Once approved, the id of who
approved will appear. The TSO userids defined in the past still remain the same. If you want to INQUIRE, REMOVE,
CHANGE, ADD a user to your approver group, please open a change request to the SECURITY group NOT Endevor.
42
Endevor Maintenance
Enhancements
ELEMENT LOCKING FOR PACKAGES
Elements, which are referenced by a package, will be LOCKED from the time the package is CAST
until the time the action which references the element is executed.

The lock facility will prevent a package from being CAST if it references a locked element.

EXAMPLE: Programmer A Created Package TESTPKG which contains MOVE SCL for
PGMA 1.3 type CBL and MOVE SCL for CPYBKA type CPY (its input component).
Package TESTPKG has been CAST.
Programmer B creates Package NEWPKG that contains MOVE SCL for
PGMB type CBL (but a BX of the element would show CPYBKA is an input
component).
Next package NEWPKG is CAST and receives error:
C1G0503E CPYBKA/CPY IS UNAVAILABLE - RESERVED BY PKG TESTPKG
Programmer B then should contact Programmer A to ensure good change management
and confirm copybook will be moved by TESTPKG. Then Programmer B can RE-CAST specifying component validation
= W.
43
Endevor Maintenance
Enhancements
This enhancement will also prevent actions executed outside a package from modifying a locked element.
EXCEPTION is a RETRIEVE or SIGNIN action.

EXAMPLE: Programmer C comes along and tries to perform a MOVE PGMA 1.4 in stage S to
Stage Q where PGMA 1.3 resides and is part of TESTPKG above. The MOVE action
will encounter an error:
C1G0503E PGMA/CBL IS UNAVAILABLE - RESERVED BY PKG TESTPKG