endevor user training guide
DESCRIPTION
complete guide on endevor toolTRANSCRIPT
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
USERNDVRSRC
T S Q P
F E
3
Inventory Mgmt - STOP & SHOP
NDBANFINANCENMACRMNPAYROLL
CPYMACCBLASMCBO
STDSTD1
PGMACPYDATE
SYSTEMS
TYPES SUBSYSTEMS
ELEMENTS
ENVIRONMENT = TST
CCID = IDENTIFIER OF A PROJECT /PROBLEM TICKETAND ALSO USEDFOR TRACKING
EZTPRCSCHJOB ... etc
NPOSNMERCHNECOMMNDINVMGT…etc
NEFTNLBTMGTNMKTINGNCATMAN
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.SOURCESP.NDV.NT.STD.JOB/PRC NT.APL.JOBLIB/PROCLIBSP.NDV.NT.STD.PR1 SP.NDV.NT.STD.PARMLIB1SP.NDV.NT.STD.KOMLIBSP.NDV.NT.STD.DBRMSP.NDV.NT.SMS.SYSD.MESSAGE SP.NDV.NT.SMS.SYSD.PANELSP.NDV.NT.SMS.SYS.SKELETONSP.NDV.NT.STD.PSB SP.NDV.NT.STD.PSBLIB/ACBLIBSP.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.SOURCESP.NDV.NS.STD.JOB/PRC NS.APL.JOBLIB/PROCLIBSP.NDV.NS.STD.PR1 SP.NDV.NS.STD.PARMLIB1SP.NDV.NS.STD.KOMLIBSP.NDV.NS.STD.DBRMSP.NDV.NS.SMS.SYSD.MESSAGE SP.NDV.NS.SMS.SYSD.PANELSP.NDV.NS.SMS.SYS.SKELETON SP.NDV.NS.STD.PSB SP.NDV.NS.STD.PSBLIB/ACBLIBSP.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.SOURCESP.NDV.NQ.STD.JOB/PRC NQ.APL.JOBLIB/PROCLIBSP.NDV.NQ.STD.PR1 SP.NDV.NQ.STD.PARMLIB1SP.NDV.NQ.STD.KOMLIBSP.NDV.NQ.STD.DBRMSP.NDV.NQ.SMS.SYSD.MESSAGE SP.NDV.NQ.SMS.SYSD.PANELSP.NDV.NQ.SMS.SYS.SKELETONSP.NDV.NQ.STD.PSB SP.NDV.NQ.STD.PSBLIB/ACBLIBSP.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.SOURCESP.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.KOMLIBSP.NDV.NP.STD.DBRMSP.NDV.NP.SMS.SYSD.MESSAGE SP.NDV.NP.SMS.SYSD.PANELSP.NDV.NP.SMS.SYS.SKELETONSP.NDV.NP.STD.PSB SP.NDV.NP.STD.PSBLIB/ACBLIBSP.NDV.NP.STD.LISTLIB
PRD
Q PPackage 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.SOURCESP.NDV.NF.STD.JOB/PRC (none)SP.NDV.NF.STD.PR1 SP.NDV.NF.STD.PARMLIB1SP.NDV.NF.STD.KOMLIBSP.NDV.NF.STD.DBRMSP.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.SOURCESP.NDV.NE.STD.JOB/PRC NE.APL.JOBLIB/PROCLIBSP.NDV.NE.STD.PR1 SP.NDV.NE.STD.PARMLIB1SP.NDV.NE.STD.KOMLIBSP.NDV.NE.STD.DBRMSP.NDV.NE.STD.PSB SP.NDV.NE.STD.PSBLIB/ACBLIB
FIX
F ESpecial 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 DON’T 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 ProcedureDevelopers 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 useridadditional 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 EnvironmentPackage 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 PERFORMEDOption ===>
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, Gotcha’s 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 reason…just 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, Gotcha’s 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 time…hence you will no longer get a cast error indicating you forgot to move a subroutine.
28
Hints, Gotcha’s and Tidbits(continued)
• Old Endevor type CICSMAP now goes to type MAP. In addition, the dsect is now written to it’s 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.SRC’…where x is stage character.
• BE CAUTIOUS: The new Endevor FIX Environment is stages F and E…the 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. AHOLD’s 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 ComponentsOPTNDRVR 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 won’t 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: 1st character is Operating Company, 2nd character is N for Endevor, 3rd character is Subsystem (X for all subsystems, A for ASTD, etc), and 4th through 8th 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 (it’s 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