IM-Anwendungsentwicklung Endevor API Denk 03/2003 Johannes
Radman
Folie 2
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Allianz
Wien SW-Entwicklung Client-Server o Power Builder o C++ o Java o
DB2 - DB2/2 Host o PL1 o (Visual-Age) o DB2 ClearCase Endevor 3.9
GFB-Geschftsfall Bearbeitung
Folie 3
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Endevor
Versionierung o REXX - PL1 - API Software-Versand Schweiz o PL1 o
ASM o VAGEN o COMPUSET o ROCHADE o SQL-Stmt o JCL-Parameter o
DB2-DDL o DB2-Load-Stmt o DB2-Unload-Stmt
ENDEVOR-Versionierung
Folie 4
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Endevor
DOKU HISTORY VERSION TEST SCHULUNG PRODUKTION EIRFVP
Folie 5
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Endevor
API o Application Program Interface o Direkter Zugriff auf
Endevor-Daten o Sample-API-Application o Eigene Applikationen
Folie 6
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 API
Sprachen o ASM, COBOL, PLI ENTBJAPI o Sample Program o Sample JCL
(BC1JCAPI) ENA$NDVR o Copybooks fr ASMECH* (z.B. ECHALELM) o
Copybooks fr CobolENH* (z.B. ENHALELM) o COB2PLI -> Copybooks fr
PLI
Folie 7
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 API List
Actions ALELM LIST ELEMENT ALENV LIST ENVIRONMENT ALSTG LIST STAGE
ALSYS LIST SYSTEM ALTYP LIST TYPE ALSBS LIST SUBSYSTEM ALPGR LIST
PROCESSOR GROUP ALDSN LIST DATA SET ALSIT LIST SITE ALAGR LIST
APPROVER GROUP ALAGJ LIST APPROVER JUNCTION AEELM EXTRACT
ELEMENT
Folie 8
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 API
Sample Program ENTBJAPI o Cobol-Hauptprogramm o Batch o
Foreground
Folie 9
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 API List
Element in Batch //APITEST EXEC PGM=NDVRC1,PARM=' ENTBJAPI
',REGION=32M,DYNAMNBR=1500 //SYSOUT DD SYSOUT=* //SYSPRINT DD
SYSOUT=* //BSTERR DD SYSOUT=* //BSTAPI DD SYSOUT=* //MSGFILE DD
SYSOUT=X,DCB=(RECFM=FB,LRECL=133,BLKSIZE=13300) //ELEMENTS DD
DSN=GRU2.ENDEVOR.ELEMENTS,DISP=SHR
//*-----------------------------------------------------------------
//* ENV SYSTEM SUBSYS ELEMENT TYPE TOENV TOSTAGE
//*4567890123456789012345678901234567890123456789012345678901 //*LM
AA APROD PAE * * *
//*-----------------------------------------------------------------
//SYSIN DD * AACTLYMSGFILE ELEMENTS ALELM FN APROD PAE * * APL* RUN
QUIT
Folie 10
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 API List
Element in Rexx dummy = ALLOCF("133 13300 FB 1 1 CYL MSGFILE")
dummy = ALLOCF("2048 22800 VB 1 1 CYL ELEMENT") dummy = ALLOCF("80
16000 FB 1 1 CYL SYSIN") "ALLOC F(SYSPRINT BSTAPI BSTERR SYSOUT)
DUMMY REUS QUEUE 'AACTL MSGFILE ELEMENT' QUEUE 'ALELM AAINTTSTE**
UBH* *' QUEUE 'RUN' QUEUE 'AACTLY' QUEUE 'RUN' QUEUE 'QUIT' "EXECIO
"QUEUED()" DISKW SYSIN (FINIS" "ISPEXEC SELECT PGM( ENTBJAPI )"
"EXECIO * DISKR ELEMENT (STEM NDVR." "EXECIO 0 DISKR ELEMENT
(FINIS" DO I = 1 TO NDVR.0... END "FREE F(SYSOUT SYSIN SYSPRINT
BSTERR BSTAPI MSGFILE ELEMENT"
Folie 11
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 API List
Actions (3.9) ALAPP LIST PACKAGE APPROVERS ALPKG LIST PACKAGE ALSCL
LIST PACKAGE SCL ALSUM LIST PACKAGE ACTION SUMMARY ALBKO LIST
PACKAGE BACKOUT INFORMATION ALBCAS LIST PACKAGE CAST REPORT ALBCOR
LIST CORRELATION RECORDS
Folie 12
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 API
Element Actions (3.9) AEADD ADD ELEMENT AEDEL DELETE ELEMENT AEGEN
GENERATE ELEMENT AEMOV MOVE ELEMENT AEPRE PRINT ELEMENT AEPRM PRINT
MEMBER AERET RETRIEVE ELEMENT AESIG SIGNIN ELEMENT AETRA TRANSFER
ELEMENT AEUPD UPDATE ELEMENT
Folie 13
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 API
Package Actions (3.9) APAPP APPROVE PACKAGE APBKI BACKIN PACKAGE
APBKO BACKOUT PACKAGE APCOM PACKAGE APCOR COMMIT PACKAGE APDEL
DELETE PACKAGE APDEN DENY PACKAGE APEXE EXECUTE PACKAGE APRES RESET
PACKAGE
Folie 14
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 API
ENA$NDVR o wird dynamisch aufgerufen (fetch call - release)
Programm mu APF-Autorisiert laufen o Lademodul-Bibliothek mu
APF-Authorisiert sein o DB2-Programm: CAF LINK o Option: AC(1)
Folie 15
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 API
PLI-Beispiel DCL ENA$NDVR OPTIONS(COBOL) ENTRY; %INCLUDE NDVALELM;
/* Copybook fr LIST ELEMENT */ %INCLUDE NDVAACTL; /* Copybook fr
Steuerung */ %INCLUDE NDVCNST; /* Copybook EAC_CONSTANTS */....
FETCH ENA$NDVR; /* ENDEVOR API laden */... AACTL_MSG_DDN =
'MSGFILE'; /* DD-Statement fr API-Messages */ AACTL_LIST_DDN =
'ELEMENT'; /* DD-Statement fr API-Output */ AACTL_SHUTDOWN = ' ';
CALL ENA$NDVR(AACTL); /* ENDEVOR API initialisieren */.... CALL
ELEMENT_LESEN;... AACTL_MSG_DDN = ''; AACTL_LIST_DDN = '';
AACTL_SHUTDOWN = 'Y'; CALL ENA$NDVR(AACTL); /* ENDEVOR API
terminieren */ RELEASE ENA$NDVR; /* ENDEVOR API freigeben */
Folie 16
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 API
PLI-Beispiel ELEMENT_LESEN: PROC; /* PARAMETER FR ENDEVOR API -
LIST ELEMENT */ ALELM_RQ_PATH = 'L'; /* EAC_PATH_LOGICAL */
ALELM_RQ_RETURN = 'F'; /* EAC_RETURN FIRST*/ ALELM_RQ_SEARCH = 'N';
/* EAC_SEARCH_NO */ ALELM_RQ_ENV = 'APROD'; ALELM_RQ_SYSTEM = '*';
ALELM_RQ_SUBSYS = '*'; ALELM_RQ_TYPE = '*'; ALELM_RQ_ELM =
'VPZJO*'; ALELM_RQ_STG_ID = 'P'; /* ENDEVOR API AUFRUFEN */ CALL
ENA$NDVR(AACTL, ALELM_RQ, ALELM_RS); IF AACTL_RTNCODE = 0 THEN /*
entweder Datenaus Struktur ALELM_RS oder FILE "ELEMENT" auslesen */
ELSE /* nix gefunden */
Folie 17
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 API - in
Prozessoren
//***************************************************************
//* INHALTLICHE PRFUNG DER ROCHADE-ATTRIBUTE - NDVITRO
//***************************************************************
//ROCHCHK EXEC PGM=CONAPI,MAXRC=4, // PARM='NDVITRO,&MEMBER
&C1SYSTEM &C1SUBSYS &C1ELTYPE' //ELEMENT DD
DSN=&&TEMP,DISP=(NEW,DELETE), //
UNIT=SYSDA,SPACE=(CYL,(5,5)), //
DCB=(RECFM=VB,LRECL=2048,BLKSIZE=0) //MSGFILE DD SYSOUT=* //BSTAPI
DD SYSOUT=* API MESSAGES //BSTERR DD SYSOUT=* API-ERROR MESSAGES
//SYSPRINT DD DSN=&&ROCHLST,DISP=(OLD,PASS)
Folie 18
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003
Dokumentation EM390API o CA-ENDEVOR for MVS API Guide
Folie 19
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
Versionsbereitstellung - Auslieferung
Folie 20
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
Versionsbereitstellung
Folie 21
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
Versionsbereitstellung neu
Folie 22
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
Versionsauslieferung
Folie 23
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
Versionsauslieferung neu
Folie 24
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 o
DEFINE/CAST PACKAGE o MOVE o ADD Beispiel TEST SCHULUNG PRODUKTION
EIRFVP o RETRIEVE Element-Actions unter TSO
Folie 25
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
- Retrieve UBHJOMW #RET
Folie 26
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
- Retrieve S
Folie 27
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
- Retrieve C A - E N D E V O R E X E C U T I O N R E P O R T
C1G0202I ACTION #1 / STMT #1 C1G0203I RETRIEVE ELEMENT UBHJOMW
C1G0204I FROM ENVIRONMENT: AINTTST SYSTEM: AE SUBSYSTEM: RW
C1G0205I TO DSNAME: GRU2.QUELL.DATA C1G0232I OPTIONS: REPLACE LIKE
MEMBER, OVERRIDE SIGNOUT, SEARCH C1G0232I COMMENT: DENK 2001
TEST-RETRIEVE/ADD C1G0275W "OVERRIDE SIGNOUT" WAS SPECIFIED FOR
ELEMENT UBHJOMW SIGNED OUT TO GRU SMGR127I ELEMENT UBHJOMW 01.58
WRITTEN TO GRU2.QUELL.DATA(UBHJOMW) C1G0200I REQUEST PROCESSING FOR
ELEMENT UBHJOMW COMPLETED, HIGHEST ENDEVOR RC WAS 0004 END OF JOB.
HIGHEST ENDEVOR RC = 0004 C A - E N D E V O R E X E C U T I O N R E
P O R T C1G0202I ACTION #1 / STMT #1 C1G0203I RETRIEVE ELEMENT
UBHJOMW C1G0204I FROM ENVIRONMENT: AINTTST SYSTEM: AE SUBSYSTEM: RW
C1G0205I TO DSNAME: GRU2.QUELL.DATA C1G0232I OPTIONS: REPLACE LIKE
MEMBER, OVERRIDE SIGNOUT, SEARCH C1G0232I COMMENT: DENK 2001
TEST-RETRIEVE/ADD C1G0275W "OVERRIDE SIGNOUT" WAS SPECIFIED FOR
ELEMENT UBHJOMW SIGNED OUT TO GRU SMGR127I ELEMENT UBHJOMW 01.58
WRITTEN TO GRU2.QUELL.DATA(UBHJOMW) C1G0200I REQUEST PROCESSING FOR
ELEMENT UBHJOMW COMPLETED, HIGHEST ENDEVOR RC WAS 0004 END OF JOB.
HIGHEST ENDEVOR RC = 0004
Folie 28
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
- Edit #add
Folie 29
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
- Add I TEST DENK 2003
Folie 30
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
- Add Batch: Foreground:
Folie 31
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
- Move UBH* I
Folie 32
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
- Move S S S
Folie 33
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
- Move TEST DENK 2003
Folie 34
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
- Move TEST DENK 2003
Folie 35
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
- Move
Folie 36
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003
Beispiel
Folie 37
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
UBHJMMA
Folie 38
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
UBHJMMA
Folie 39
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003 Beispiel
HF021221
Folie 40
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003
Beispiel
Folie 41
E n d e v o r A P I IM-Anwendungsentwicklung Denk 2003