Endevor allows the user to archive elements to a sequential dataset. This may be needed do to the requirement to keep a history of an element that is either no longer needed or has had a major architectural change.
There are two processes that relate to the archive dataset, archive the element and if necessary restore the element to the Endevor system. This section of the guide details both the archive and restore procedures.
Procedure for Archiving Endevor elements
----------------------
Package Foreground Options Menu ------------------------ Option ===> 2
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 ===> prtec052101lds1
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
MODIFY
-------------------- CREATE/MODIFY PACKAGE ------------------------ OPTION ===> b
B - Build Package Actions I - Import SCL E - Edit Package C - Copy Package N - Add Notes to Package
PACKAGE
ID: PRTEC052101LDS1 STATUS: IN-EDIT DESCRIPTION ===> archive
adp001 PACKAGE
TYPE ===> STANDARD
SHARABLE PACKAGE ===> Y
(Y/N) APPEND TO PACKAGE
===> N (Y/N) ENABLE
BACKOUT ===> Y (Y/N)
EXECUTION
WINDOW FROM ===> 07MAY01
INPUT
PACKAGE ID ===>
------------------------------- SCL GENERATION
----------------------- OPTION ===> 13
1 DISPLAY - Display an element 2 ADD/UPDATE - Add or update an element into stage
1 3 RETRIEVE - Retrieve or copy an element 4 GENERATE - Execute the Generate Processor for
this element 5 MOVE - Move an element to the next
inventory location 6 DELETE - Delete an element 7 PRINT ELEMENT - Print elements,
changes and detail change history 8 SIGNIN - Explicitly sign-in an
element 9 TRANSFER - Transfer elements between two
ENDEVOR locations 10 PRINT MEMBER - Print a compressed listing or
member 11 LIST ELEMENT - Create List actions for ENDEVOR
elements 12 LIST MEMBER - Create List actions for external
members 13 ARCHIVE - Archive elements 14 ADD/UPDATE - Add or update a CSP element into
stage 1 15 RETRIEVE - Retrieve or copy a CSP element
Enter DD name in 'To File' to identify the Archive dataset
----------------------------- ARCHIVE ELEMENTS ------------------------- OPTION ===>
ELEMENT
DISPLAY OPTIONS: blank - Element
list S - Summary B - Browse H - History V - Archive element M - Master C - Changes
FROM
ENDEVOR: ACTION
OPTIONS: ENVIRONMENT ===> DEV2STEP CCID ===> SYSTEM ===> team51 DELETE 'FROM' ELEMENT ===>
N (Y/N) SUBSYSTEM ===> TECHSERV OVERRIDE SIGNOUT ===> N (Y/N) ELEMENT ===> adp001
TYPE ===>
STAGE ===> p 2 - DEV2PROD P - PROD
COMMENT ===> archive adp001
TO
FILE ===> t51arc
LIST OPTIONS:
DISPLAY
LIST ===> Y (Y/N)
WHERE CCID EQ ===>
WHERE PROC GRP EQ
===> BUILD USING MAP ===> N (Y/N) **
To File Entries ** T48ARC,
T49ARC, T51ARC, T53ARC, T54ARC, T56ARC, T57ARC, T77ARC, T85ARC, T91ARC,
& T94ARC
ARCHIVE
----------------- ELEMENT
SELECTION LIST ---------- Row 1 to 1
of 1 COMMAND
===>
SCROLL ===> PAGE
FROM Environment: DEV2STEP System: TEAM51 Subsystem: TECHSERV TO File: T51ARC
ELEMENT STG TYPE VV.LL COMMENT v ADP001
P COBOL 01.01 ARCHIVE ADP001
Enter 'V'
next to element you want to archive
After Archive SCL is written, PF3 back to the Package Foreground Options Menu. You can now Cast the package and have it Approved. Endevor Package Processing will Archive the element to the 'To File' DD dataset name that was previously entered.
Note: To File DD names of
T48ARC, T49ARC, T51ARC, T53ARC, T54ARC, T56ARC, T57ARC, T77ARC, T85ARC, T91ARC,
& T94ARC relate directly to team numbers. i.e. T49ARC would be used by Team
49.
This is a procedure for Restoring an Archived Endevor element from the Archive
dataset. This procedure is a combination
of edits and Endevor procedures for submitting a batch job. If there is a requirement to Restore the source to the Production Source dataset, then
the user must create a Package. For
Package processing, use the SCL examples in this section as a reference. Reference Endevor for
OS/390 SCL Reference Manual for SCL parameters.
Restore Element Steps:
1. Create Restore SCL
2. Submit Endevor Batch Restore
Job
This step requires that you create SCL that will be used by the Endevor Batch job.
An example of the Restore SCL is located at DHR.BDA.TEAM51.NDVR.SCL.EXAMPLES, member RESTELM.
1. Copy RESTELM to either your TSO Id's or Team's dataset that has a RECFM=FB and an LRECL=80.
2. Edit the RESTELM SCL to your requirements. Modify the parameters that are in Bold, & Italicized.
RESTORE
ELEMENT 'ENDVCOB1'
FROM FILE T51ARC
ENVIRONMENT 'DEV2STEP' SYSTEM 'TEAM51' SUBSYSTEM 'TECHSERV'
TYPE 'COBOL' STAGE NUMBER 2
TO ENVIRONMENT 'DEV2STEP' SYSTEM 'TEAM51' SUBSYSTEM 'TECHSERV'
TYPE 'COBOL' STAGE NUMBER 2
OPTIONS COMMENTS "RESTORE
ENDVCOB1 FROM ARCHIVE"
.
Note: The
From File DD names of T48ARC,
T49ARC, T51ARC, T53ARC, T54ARC, T56ARC, T57ARC, T77ARC, T85ARC, T91ARC, &
T94ARC relate directly to team numbers. i.e. T49ARC would be used by Team 49.
When you are finished editing the RESTELM SCL, you will go to Endevor Batch to submit the job to restore the element from the archive dataset.
The first step in submitting the Restore Job is to build the JCL that defines the Archive Dataset.
BATCH -----------------------
BATCH OPTIONS MENU
---------------------------- OPTION ===> 5
1 BUILD SCL - Build batch SCL
actions 2 EDIT - Edit request data set 3 SUBMIT - Submit job for batch processing 4 VALIDATE - Check request data set for
syntax errors 5 BUILD JCL - Enter additional JCL to be
included with the job
REQUEST DATA SET: PROJECT ===> APPEND ===> N (Y/N) GROUP
===>
INCLUDE JCL ===> Y (Y/N) TYPE
===> MEMBER
===>
<<< This field is for the scl
only
OTHER PARTITIONED OR SEQUENTIAL DATA
SET: DSNAME ===> TS51S54.NDVR.SCL(RESTELM)
JOB STATEMENT INFORMATION: ===> //TS51S54R JOB (DHRTEC,ADIX),SCHLENZ.50582.TS.AND,REGION=0K, ===> // CLASS=H,TIME=5,MSGCLASS=2,NOTIFY=TS51S54 ===>
===>
----------------------------
Additional Batch JCL ----------------------------- Command
===>
.........1.........2.........3.........4.........5.........6.........7.. 1.
//T51ARC DD DSN=DHRTSO.TEAM51.ARCHIVE, DISP=SHR 2.
________________________________________________________________________
After the additional JCL to define the Archive dataset is created, Submit Restore Element Batch Job. A Validate is recommended but is not required prior to submitting the Restore Job.
BATCH -----------------------
BATCH OPTIONS MENU ---------------------------- OPTION ===> 3
1 BUILD SCL - Build batch SCL
actions 2 EDIT - Edit request data set 3 SUBMIT - Submit job for batch processing 4 VALIDATE - Check request data set for
syntax errors 5 BUILD JCL - Enter additional JCL to be
included with the job
REQUEST DATA SET:
PROJECT ===> APPEND ===> N (Y/N) GROUP
===>
INCLUDE JCL ===> Y (Y/N) TYPE
===>
MEMBER
===>
<<< This field is for the scl
only
OTHER PARTITIONED OR SEQUENTIAL DATA
SET:
DSNAME ===> TS51S54.NDVR.SCL(RESTELM)
JOB STATEMENT INFORMATION:
===> //TS51S54R JOB (DHRTEC,ADIX),SCHLENZ.50582.TS.AND,REGION=0K, ===> // CLASS=H,TIME=5,MSGCLASS=2,NOTIFY=TS51S54 ===>
===>