4.1.

Endevor
1. Endevor este un instrument de elaborare al softului pentru aplicaii Mainframe. El combin funciile de
sistem de cutare, ambient de elaborare, compilator i control al versiunilor. Accesarea Endevor se
efectuiaz din meniul principal utiliznd comanda A.Q sau n unele ambiente A;E;2;U;E.
2. Componentele ferestrei Endevor:
Meniuri i ferestre
interactive
Comenzi
(acceptabile doar de
obiecte individuale)
Filtre de cutare

Opiuni de acces i
compilare
Linia de comand
Meniurule i ferestrele interactive servesc pentru calibrarea fin a
opeaiunilor default efectuate de Endevor la ndeplinirea diverselor
comenzi (cum ar fi crearea, compilarea sau editarea obiectelor Endevor).

Opiuni auxiliare
de filtrare

Comenzile permit efectuarea operaiilor cu obiecte individuale n lista elementelor selectate (descris n
punctul 3 al documentului curent).
Filtrele de cutare ordonarea i gruparea logic a obiectelor individuale n Endevor permite diminuarea
timpului de cutare ulterioar a acestora. Cmpurile date sunt deasemnea utilizate pentru a indica unele
caracteristici fundamentale ale obiectelor ce urmeaz a fi create n Endevor.
ENVIRONMENT obiectele cutate trebuie s fac parte din ambientul indicat. n caz normal este
utilizat MVSSVL, ceea ce nseamn c obiectele trebuie s aparin ambientului elaborare (Sviluppo).
Alte ambiene accesibile pe serverul S1 sunt MVSMNT (mentinan), MVSPRD (producie), . a.
SYSTEM & SUBSYSTEM permit gruparea obiectelor Endevor n categorii n baza domeniului lor de
aplicare. n MVSSVL exist peste 200 Systeme (mai numite i proceduri), fiecare dintre acestea poate
avea zeci de SubSysteme. Ultimele reprezint de proiecte i servicii separate din care este compus
sistemul informaional Cedacri. Obiectele Endevor elaborate n cadrul cursului de studii, precum i
orice alte obiecte create n lipsa unei cereri oficiale, trebuie declarate n Systemul XX i SubSystemul
XX (masa de lucru sau maculator).
ELEMENT numele obiectului cutat/creat. Numele obiectelor poate fi compus din cel mult 8
caractere. n cazul obiectelor create regulamentar, numele acestora va conine indicaii i componente
descriptive privitoare obiectul n cauz. Spre exemplu primele 2 caractere ale denumirii indic de
obicei procedura din care face parte obiectul. Tipul este n unele cazuri descris de caracterele 3-6.
Toate obiectele produse n cadrul cursului de studii trebuie s nceap cu CRxxx indicnd astfel
apartenena obiectului. Filtrul Element accept deasemenea caractere specifice pentru a facilita
cutarea:
o % nlocuiete un singur caracter. Ex: CR050%%1 > va gsi CR050PB1 i CR050PT1.
o * nlocuiete orice numr de caractere la sfritul irului. Ex: CR050* > va gsi toate
elementele care ncep cu CR050.
TYPE utilizat pentru a indica tipul obiectului care urmeaz a fi gsit/creat. n MVSSVL pot fi create
45 tipuri de obiecte (programe, structuri, tabele, etc.). Programele Cobol Batch aparin tipului PBC.

Opiuni de acces i compilare:

CCID etichet logic utilizat pentru a grupa/marca obiectele care fac parte din acelai proiect. Este
utilizat la faza de system test i la trecerea obiectelor legate logic ntre dintr-un ambient n altul.
Processor Group determin modul n care compilatorul interpreteaz codul surs i modulele
default care se declar automat de sistem la momentul compilrii.
o COENDBCH processor group standard pentru programele PBC/PTC care nu conin interpelri SQL.
o COEDB2CH processor group aplicat n cazul PBC-urilor ce conin interpelri SQL (EXEC SQL ...).
Override Signout reprezint un instrument simplu de siguran. Pentru a edita/compila un
obiect care a fost anterior editat/compilat de o alt persoan, se cere specificarea intenionat a valorii
Y n acest cmp. De altfel accesul la obiectul n cauz va fi interzis.
Opiuni auxiliare de filtrare:
APPLY LIST FILTERS Permite aplicarea filtrelor
adugtoare n baza valorii CCID, a matricolei din cea mai recent
versiune, a Processor Group-ului, . a.

BUILD USING MAP indc faptul c lista trebuie s conin att obiectele aflate n SVL ct i
versiunile lor din alte ambiente vizibile n MVSSVL (cum ar fi COL sau RIL):

RETURN FIRST FOUND n cazul n care obiectul exist n mai multe ambiente (spre exemplu i n
SVL i n RIL), n list va fi inclus doar cea mai recent versiune a obiectului gsit:

DISPLAY ENV/SYS/SUBSYS LIST n cazul n care filtrele ENVIRONMENT, SYSTEM i

SUBSYSTEM nu sunt valorizate, Endevor va cere valorizarea obligatorie a acestora n ferestre de dialog
cu afiarea listei de valori admisibile.

Comenzi acceptabile
3. Lista Elementelor Selectate i comenzile aplicabile obiectelor individuale:
n imaginea dat, unele obiecte
au att versiuni n SVL ct i
versiuni n RIL. Aa situaii
apar din motiv c versiunile
verificate i stabile din RIL
sunt utilizate de sistem la
nivelul
clientului,
iar
versiunea din SVL este mai
nou i se afl nc n stadiul
de elaborare.

Denumirea
Tipul
Ambientul
Systemul i
Versiunea
obiectului
obiectului
versiunii
SubSystem
curent
curente
ul
B Vizualizarea coninutului obiectului n regim Read-only.
E Deschide obiectul pentru editare. Cere introducerea unui CCID valid i prezena drepturilor de
editare. Creaz o versiune nou a obiectului n SVL n cazul n care obiectul editat aparine unui alt
ambient.
# Elimin obiectul indicat. Aplicabil doar obiectelor aflate n ambientul SVL. Cere introducerea unui
CCID valid i prezena drepturilor de editare.
G Recompilarea obiectului indicat. Cere introducerea unui CCID valid i prezena drepturilor de
editare. Creaz o versiune nou a obiectului n SVL n cazul n care obiectul recomilat aparine unui alt
ambient.
M Afieaz caracteristicile detaliate ale obiectului.
Deintorul curent al
drepturilor de editare

Ultimul
processor utilizat

CCID-ul curent
al obiectului

Rezultatul compilrii
precedente

S Afieaz lista versiunilor obiectului. O versiune nou este creat la fiecare salvare a codului editat.

Numrul
Data/ora Nr. rnduri Nr. rnduri Nr. rnduri
Autorul
versiunii
apariiei
introduse eliminate
C Permite examinarea rndurilor introduse, modificate sau eliminate n fiecre versiune:

Versiunea n care Versiunea n care rndul

rndul a fost introdus
a fost eliminat

Coninutul rndului

SI Preluarea drepturilor de editare. Permite gestionarea unui obiect care a fost creat/editat/compilat
anterior de o alt persoan.

Elementul indicat mai sus nu poate fi editat deoarece

la moment drepturile de editare i aparin unei alte matricole.
Comanda SI transfer drepturile de editare matricolei care efectuiaz operaia.

H Permite vizualizarea coninutului obiectului afind simultan toate versiunile tutror rndurilor
prezente la moment n cod.

Coninutul rndurilor date

n diferite versiuni
4. Declararea obiectelor Endevor:
Programarea unui program Batch scris n COBOL ncepe de la declararea n Endevor a unui obiect de tip
PBC cu toate caracteristicile cuvenite:

n imagine sunt indicate toate setrile obligatorii

necesare la declararea unui obiect Endevor de tip PBC.

Pentru a crea un obiect PBC n Endevor sunt necesare urmtoarele valorizri:

ENVIRONMENT.. MVSSVL unicul ambient n care pot fi declare obiecte Endevor noi fr abilitri
suplimentare.

SYSTEM....... XX Systemul i SubSystemul care corespund unui maculator. Reprezint

SUBSYSTEM.... XX unicul loc unde obiectele Endevor pot fi create neoficial.

ELEMENT...... CR050PB1 Denumirea obiectelor create neoficial, adic create n scop de test
sau exerciiu, fr cerere oficial. Trebuie s includ neaprat matricola autorului (persoanei
responsabile de acest obiect). n cazul prezenei unei cereri oficiale, denumirea obiectului se indic n
analiza tehnic a proiectului. Obiectul trebuie eliminat atunci cn nu mai este nevoie de el !
TYPE......... PBC tipul obiectelor Endevor care corespund programelor Batch COBOL.

CCID.............. TEST unicul CCID valid universal i utilizat n cazul obiectelor create
neoficial. n restul cazurilor, valoarea CCID-ul se indic de analist n analiza tehnic sau este cerut
aparte de la responsabilul de proiect.
Processor Group... COENDBCH procesorul standard aplicat n cazul programelor COBOL
care nu conin interopelri SQL. Alternativ este utilizat COEDB2CH.
Command ===> CR comanda de creare a obiectului Endevor cu caracteristicile specificate.
Obiectul apare cu adevrat n Endevor i catalogul aferent ambientului doar dup prima operaie de
salvare.

5. Editarea, salvarea, compilarea:

Fereastra de editare deschis n Endevor este identic cu cea utilizat pentru a edita coninutul oricrui
fiier sau membru. Sunt valide aceleai comenzi i principii de funcionare.
Salvarea se efectuiaz automat la ieire cu tasta F3 sau dup comanda SAVE.
Compilarea unui obiect poate fi efectuat aplicnd comanda G obiectului n cauz n Lista Elementelor
Selectate sau la ieire cu F3 din obiectul editat.
nainte de a compila codul obiectului
sistemul va propune includerea
modulelor auxiliare pentru procesul
de compilare. Ele vor fi discutate n
documentele urmtoare.
Pentru
moment, tastai de 2 ori Ctrl i
purcedei la compilare.

Obiectele Endevor sunt compilate

utiliznd classa special S.

6. Gestionarea versiunilor:
Dup fiecare salvare, este produs o nou versiune a obiectului n cauz.
Numrul
versiunii
Autorul
versiunii
Data i ora
modificrii

Versiunea n care
rndul a fost
inserat/modificat

CCID-ul
utilizat

Ultima compilare
reuit
Codul surs

Toate modificrile efectuate la producerea versiunii sunt nregistrate i o versiune poate fi indicat ca
curent la orice moment.

7. Sourcebt i Load
Codul surs al obicetelor Endevor de tip PBC sunt nregistrate drept membri n catalogul
SVL.CHANGE.BP.SP.SOURCEBT. Numele membrilor corespunde numelui obiectului declarat n
Endevor. Fiecare ambient pe fiecare server are o versiune aparte a librriei date:
Sviluppo
SVL.CHANGE.BP.SP.SOURCEBT
Collaudo
COL.CHANGE.BP.SP.SOURCEBT
Rilascio
RIL.CHANGE.BP.SP.SOURCEBT
Avviviamento AVV.CHANGE.BP.SP.SOURCEBT
Addestramento ADD.CHANGE.BP.SP.SOURCEBT
Mantenuzione MNT.CHANGE.BP.SP.SOURCEBT
Emergenza
EMR.CHANGE.BP.SP.SOURCEBT
Produzione
PRD.CHANGE.BP.SP.SOURCEBT
Dup compilare, codul compilat al obiectelor Endevor este ntregistrat ca membru cu cod main n
catalogul xxx.CHANGE.BP.SP.LOAD.LE, unde xxx corespunde ambientului (exact cum mai sus).
Atenie, n LOAD.LE nimerete codul compilat nu doar al obiectelor PBC ci i a obiectelor de alte tipuri.
Deci pentru a lansa un PBC cu numele CR50XXX este utilizat urmtorul cod JCL:

Fluxul STEPLIB efectuiaz conexiunea ntre programul JCL i codul compilat al programului
CR50XXX aflat n librriile LOAD.LE. n cazul din exemplul de mai sus fluxul STEPLIB este compus
din 2 librrii. Astfel codul programului apelat este cutat consecutiv de sus n jos n toate librriile
indicate. De regul librriile sunt aranjate astfel nct
Alternativ poate fi utilizat fluxul JOBLIB. Acesta se declar o singur dat i precedeaz STEPurile. Spre deosebire de STEPLIB, care ine doar de STEP-ul n care este declarat, fluxul JOBLIB are
efect asupra ntregului JOB.
n cazul n care un program JCL conine att JOBLIB-uri ct i STEP-lib-uri, mai nti sunt puse n
funciune librriile din STEPLIB.
Lansarea proglamului are loc n mod convenional, utiliznd comanda SUB.
n cazul n care obiectul apelat nu este
gsit nici n una din librriile indicate
n JOBLIB i STEPLIB, executarea
programului JCL este oprit cu codul
de eroare S806.

...