XML on z/OS and OS/390: introduction to a service-oriented architecture [1st ed] 0738426156

Citation preview

•

Table of Content s

•

I ndex

X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

Pub lish er: I BM Pub Dat e: Ju ne 11, 2 00 3 I SBN: 0- 73 84- 26 15 -6 Pages: 26 4

Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS I m plem ent solu t ions based on p r act ical ex amp les This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em pr ogr am m er s an d applicat ion p rog ram m er s. The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n.

•

Table of Content s

•

I ndex

X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

Pub lish er: I BM Pub Dat e: Ju ne 11, 2 00 3 I SBN: 0- 73 84- 26 15 -6 Pages: 26 4

Copy right Pref ace

Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 The t eam th at wrot e th is r edbo ok

Become a pucept blished au t hor Desig n con s for W eb ser v ices ar chit ect ur es on z/ OS Com ment s welcome

I m plem ent ions based Part 1: XML on solu z/ OS tan d OS/ 39 0

on p r act ical ex amp les

Cha pter 1. XML concept s

This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it Section 1 .1 . XML int ro duct ion can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of Section 1 .2 . Docum ent ty pe def init ion ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. Section 1 .3 . Namespaces Section 1 .4ov . XML Schem I n addit ion t o an erv iew ofa XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or 1inst XMLStyToolk f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le Section .5 . alling XSL – Ext the en sible lesheetit Langu age pr ogr am sSection bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices 1 .6 . XHTML dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an Section 1 .7 . XSL, XSLT, Xpat h, an d XHTML exam ples ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em Section 1 .8 . Real-lif e uses of XML pr ogr am m er s an d applicat ion p rog ram m er s. Cha pter 2. XML Toolk it fo r z/ OS and OS/ 39 0

Section oolkit com ts m ore t o t he need s of applicat ion developer s and The second par t2 .1 of. tXML h e tbook is gponen ear ed Section .2 . Operat ing en vrireh onm t s e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d ar ch it ect s. I t pr2ovid es a comp enensiv Web ser vices, ibes V1R4 in det some based t op ologies for b ot h legacy sy st em s an d Sectionand 2 .3 . descr XML Toolkit in ail st alla tion anser d covicenfigu rat ion new ap plicat ion2s..4 .Fin , tconsiderat h is bookionpr Section Rually nt ime s esen t s some im p ort an t d esign concep t s t o en able t he r ead er Cha t o bpter uild obuToolk st SOAased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM 3. r XML it sambples Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by Section 3 .1 . Jav a sam ples cont r act an d ser vice desig n. Section 3 .2 . C/ C+ + sam ples

Cha pter 4. Serv ices dev elopm en t env iron ment Section 4 .1 . Elem ent s o f e- busin ess dev elo pment t ools Section 4 .2 . WebSphere St udio En t erp rise Dev eloper Section 4 .3 . Suppo rt f or en terpr ise serv ice developm ent Section 4 .4 . WebSphere St udio Asset Analy zer Section 4 .5 . XML reposit ory Cha pter 5. XML and En t erp rise COBOL Section 5 .1 . Ov er view

Section 5 .2 . COBOL an d Jav a in teroperat ion Section 5 .3 . XML su pport in Ent erprise COBOL f or z/ OS Section 5 .4 . WebSphere St udio En t erp rise Dev eloper & COBOL Cha pter 6. WebSph ere Applicat ion Serv er on z/ OS and OS/ 39 0 Section 6 .1 . I BM WebSph ere Applicat ion Serv er Section 6 .2 . Th e WebSp here f or z/ OS env ironm ent Section 6 .3 . Applicat ion deploym ent

• •

Table of Content s

Section 6 .4 . Developm ent -t im e and ru n-t im e con sider at ion s

I ndex

Section 6 .5 . Applicat ion considerat ion s X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e Part 2: Serv ice-orien ted archit ect ure By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona Cha pter 7. Serv ice-o rien t ed arch itect u re and Web serv ices Section 7 .1 . I n t roduct ion Pub lish er: I BM Section 7 .2 . SOA definit ion Pub Dat e: Ju ne 11, 2 00 3 Section 7 .3 . Web Serv ices ov erv iew I SBN: 0- 73 84- 26 15 -6 Cha pter 8. Some ser vice- based solu t ion t opolog ies Pages: 26 4 Section 8 .1 . Solut ion t opology f or legacy sy st em s Section 8 .2 . Solut ion t opology f or new ap plica tion s Cha pter 9. JCA and WebSph er e conn ect ors Section 9 .1 . J2EE Co nnect or Archit ect ure o verv iew Section 9 .2 . WebSphere co nnect ors Section 9 .3 . Tra nsact ion m anagemapplicat en t Lev er age XML and XSLbased ions on z/ OS and OS/ 39 0 Cha pter 10 . Som e k ey design guidelines

Desig n con1 0. cept s for v ices Section 1. Pat ternW s f eb or e-ser busin ess ar chit ect ur es on z/ OS Section 1 0. 2. XML- based m essage design

I m plem ent solu t ions based on p r act ical ex amp les Section 1 0. 3. Design by Co nt ract a nd Serv ice Design

Glossary This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it ed pub can be Relat ext end edlicat t o ion m sodern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- orI BM ienRedbook t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. s Referenced Web sit es

I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed How t o get I BM Redbook s inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le Back cov er pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices I n dex dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em pr ogr am m er s an d applicat ion p rog ram m er s. The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n.

Copyright •

Table of Content s

•

I ndex

I nt er nat ional Techn ical Su ppor t Or ganizat ion

X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e ByML Franck Jose Luis OS/ Fern andez Dipak ct Hore, Carm X on I nj z /ey,OS and 3 9 0 :Last I nrat ,rodu i onDavid t o aSanch S er ez vi ce - Oona ri ent ed Ar ch it e ct ure

MayPub 2 003 lish er:

I BM

Pub Dat e: Ju ne 11, 2 00 3 I SBN: 0- 73 84- 26 15 -6 Pages: 26 4

Not e Befor e using t his in for m at ion an d t he p rod uct it su ppor t s, r ead t he inf orm at ion in " Not ices" on p age v ii. Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS

First Edition (May 2003)

I m plem ent solu t ions based on p r act ical ex amp les This edit ion app lies t o I BM XML Toolk it f or z/ OS and OS/ 39 0 V1 . 4, pr og ram num ber 5 655 - J51 This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it for use w it h: can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v iceor ien ar chit ect ur e 3along it h p det4-ailed m at ionVersion ab out XML. z/ OS Vert ed sion 1 Release pr ogrwam nur act mbical, er 569 A01 in orfor OS/ 390 2 Release 10 pr ogr am n um ber 56 47- A0 1. I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or t he Serv XML er Toolk z/ OS and OS/ 3939 0 V1. an d ice ru nning h epr samp le WebSph er einst Apalling plicat ion V4.it 0.f1orf or z/ OS and OS/ 0 at4 Serv Lev el t 4, og ram pr ogr nu ammb s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices er 565 5- F31 dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov v iewriof I BM Web Spher e si App ionchSer er Corp . Thisormaat er ial2 0 is0of est msainly o sy st em © er Copy ghtt he I nt e rna t i ona l Bu nelicat ss Ma inev s t ion 3 . inAlt er l ri ght re setrv e d. pr ogr am m er s an d applicat ion p rog ram m er s. Not e t o U. S. Gover nm ent Users Rest r ict ed Rig ht s - - Use, d uplicat ion or disclosur e r est r ict ed by The second par t of h e book is itghear ed Cor m ore GSA ADP Schedu le tCont r act w I BM p. t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by This in for m at ion w as d ev eloped f or pr od uct s and ser v ices of fer ed in t he U. S. A. cont r act an d ser vice desig n.

Notices

I BM m ay n ot of fer t h e pr oduct s, serv ices, or feat ur es discu ssed in t h is docum ent in ot h er count r ies. Consult y our local I BM r epr esent at iv e f or inf orm at ion on t he p rod uct s and serv ices cur r en t ly available in y our ar ea. Any r efer en ce t o an I BM p r oduct , p rog ram , or ser v ice is n ot int end ed t o st at e or im ply t hat only t h at I BM pr odu ct , pr ogr am , or serv ice may be used. An y fu nct ionally equiv alen t p rod uct , pr ogr am , or ser vice t h at does n ot inf r inge an y I BM int ellect u al pr oper t y r ight m ay be u sed inst ead. How ever , it is t he user 's r esponsibilit y t o ev aluat e an d v erif y t he operat ion of any non- I BM pr oduct , pr ogr am, or ser v ice. I BM m ay h ave pat ent s or pending pat en t app licat ions cov er in g su bject m at t er d escrib ed in t his docum ent . The f ur nish ing of t his d ocu ment does not giv e y ou any license t o t hese pat ent s. You

can send license inq uir ies, in w r it in g, t o: I BM Direct or of Licen sing, I BM Cor por at ion , Nor t h Cast le Dr iv e Ar m onk , NY 1050 4- 1 785 U.S. A . The f ollow in g p aragr aph does n ot ap ply t o t h e Un it ed Kin gdom or an y ot her coun t r y w here su ch pr ov isions ar e in consist ent wit h local law : I NTERNATI ONAL BUSI NESS MACHI NES CORPORATI ON PROVI DES THI S PUBLI CATI ON " AS I S" W I THOUT WARRANTY OF ANY KI ND, EI THER EXPRESS OR I MPLI ED , I NCLUDI NG, BUT NOT LI MI TED TO, THE I MPLI ED W ARRANTI ES OF NON• Table of Content s I NFRI NGEMENT, MERCHANTABI LI TY OR FI TNESS FOR A PARTI CULAR PURPOSE. Some st at es d o •not allow disclaim I ndex er of exp ress or im plied w ar r ant ies in cer t ain t ran sact ions, t h er efor e, t h is X on z / OSm a nd / 3 9app 0 : I ly nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e stML at ement ay OS not t o y ou. By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

This in for m at ion could include t echn ical in accur acies or t y pogr aph ical er r or s. Chan ges are per iodically m ade t o t h e infor m at ion her ein; t hese chang es w ill b e incorp or at ed in new edit ions Pub lish er: I BM of t he pub licat ion. I BM m ay m ake im pr ov ement s and/ or ch anges in t he p r oduct ( s) an d/ or t h e Pub Dat e: Ju ne 11, 2 00 3 pr ogr am ( s) d escr ib ed in t his p ublicat ion at any t im e w it h out n ot ice. I SBN: 0- 73 84- 26 15 -6 Pages: 4 in t his in for m at ion t o non - I BM Web sit es ar e p rov ided for conv enience only and Any r efer en 26 ces do not in an y m anner serv e as an end orsement of t hose Web sit es. Th e m at er ials at t hose Web sit es are n ot p art of t he mat er ials for t his I BM p r oduct and use of t hose Web sit es is at y our ow n r isk .

I BM m ay u se or dist r ib ut e an y of t he in for m at ion y ou supply in any way it believ es app rop riat e w it hout r ing any obXSLlig at ion t o yapplicat ou. Levincur er age XML and based ions on z/ OS and OS/ 39 0 I nf orm at ionn concer nin I BM oduct w as ained f r OS om t he su ppliers of t hose pr odu ct s, Desig con cept s g forn onW eb serpvrices arschit ectob urtes on z/ t heir p ublished an noun cem ent s or ot her pub licly av ailab le sour ces. I BM h as not t est ed t hose pr oduIct and ent cannot m t h e on accu of pexeramp for mles ance, com pat ibilit y or any ot her claim s msplem solu tconfir ions based p rracy act ical r elat ed t o n on- I BM pr oduct s. Qu est ions on t he capabilit ies of non- I BM pr odu ct s sh ould be Thisressed add I BM Redbook t o t he sup descr plier ibes s oft he t h ose u sepof r oduct XMLs.on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of This in for attion cont ain s ur exam ples wofit h dat and r epdet or ailed t s used in m daily b usin essXML. op er at ions. To ser v iceorm ien ed ar chit ect e along p raact ical, in for at ion ab out illust rat e t hem as com plet ely as possib le, t he exam ples includ e t he n ames of ind ividu als, I n addit com panies, ion tbr o ands, an ov erv an diew pr oduct of XML s. concep All of t ht s, ese t he nam f irst espar ar et of f icttithious e book andp rany ovides simdilar et ailed it y t o t he inst r es nam uctand ions add f or rinst esses alling used t hebyXML an act Toolk ualitbusiness f or z/ OS ent and erp OS/ r ise 39is0 ent V1.ir4ely an dcoin ru nning cident tal. h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices COPYRI CENSE: dev elop GHT mentLIenv ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em This formmeratsion ain s samp pr ogrinam an dcont applicat ion p le rogapplicat ram m erion s. p r ogr ams in sour ce langu age, w hich illust r at es pr ogr am m ing t ech niques on v ariou s oper at ing plat for m s. You m ay cop y, m odify , and d ist r ibu t e tThe hese sam ple prt ogr in any w itmh ore out tpay m en t t osI BM, for t heion p urdeveloper poses of sdeveloping , second par of tam h e sbook is gf orm ear ed o t he need of applicat and using , m ark et ing or dist r ibut in g ap plicat ion pr og ram s conf or min g t o t he applicat ion ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d pr ogrser amvices, m ing int erfdescr ace for t he at ing plat f orm w h ich sam ple ogr aresywr it t en. Web and ibes in oper det ail some ser vice-for based t opt he ologies for pbrot h ams legacy st em s an d These exam ples hav e n ot been t hor ough ly t est ed un der all condit ions. I BM, t her ef ore, cann new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he ot gu aran imr ply eliabilit , ser vsolu iceabilit or f unct ionis of t hese s. You ayt he copy , r ead er t ee o bor uild oburst SOA- by ased t ionsy ,r apidly . Th in clu des pr anogr intam r oduct ionmt o I BM m odify , an d dist ribu t e t hese sam ple pr ogr am s in any f orm w it hout pay m en t t o I BM f or t he Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by pu rproses ofddser ev elop usin cont act an viceing, desig n. g, m ar k et in g, or d ist r ibu t ing applicat ion pr ogr ams con for m ing t o I BM's applicat ion p r ogr amm ing int er faces.

Trademarks The f ollow in g t er m s ar e t r adem ark s of t h e I nt ern at ional Bu sin ess Machin es Corp or at ion in t he Unit ed St at es, ot h er cou nt r ies, or bot h:

AI X®

I BM®

PR/ SM™

CI CS®

I MS™

RACF®

DB2 Univer sal Dat ab ase™

Lan guag e Env ir onm ent ®

Redb ooks ( log o)

DB2 ®

Lot u s®

Redb ooks™

MQSer ies®

S/ 37 0™

•

Table of Content s

• Dom ino™

I ndex

XDRDA® ML on z / OS a nd OS / 3 9 0 : I nt roduct ion MVS™ t o a Se r vi ce- Or i ent e d Ar chi te ctur e By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

En cin a®

Net . Dat a®

En Pub t er lish p rise er: ISy BMst em s

Not es®

Pub Dat e: Ju ne 11, 2 00 3

Ar ch it ect u re/ 39 0®

S/ 39 0® Sy st em / 36 0™

OS/ 2 ®

VisualAge®

OS/ 3 90®

WebSph er e®

FI CON™

OS/ 4 00®

z/ OS®

ibm . com ®

Par allel Sy splex®

zSeries®

I SBN: 0- 73 84- 26 15 -6

ESCON® Pages:

26 4

The f ollow in g t er m s ar e t r adem ark s of I nt er nat ional Business Mach ines Cor por at ion and Rat ional LeveerCorp age orat XMLion and z/ OSr ies, and or OS/ 39h 0: Soft war , inXSLt he based Unit ed applicat St at es, ions ot heroncount bot Rat ionDesig al® n con cept s for W eb ser v ices ar chit ect ur es on z/ OS I m plem solu t ions basedark ons pofr act ex amp The f ollow in gent t er m s ar e t r adem ot hical er com panles ies: This Redbook t he an u se of XML ser v er OSpor or at OS/ I nt el,I BM I nt el I nside (descr log os)ibes , MMX d Pen t iumon arIeBM t r adem arsksr un of ning I nt elz/Cor ion3 90, in t han e dUnhow it ed it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high lev el discu ssion of St at es, ot her coun t ries, or b ot h. ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. Micr osof t , Wind ow s, Window s NT, an d t he Wind ow s logo are t rad em ar k s of Micr osoft Cor por at ion I n taddit ioned t o St anatov XML concep t s, ht.he f irst par t of t h e book p r ovides d et ailed in he Unit es,erv otiew her of count r ies, or bot inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr Jav a an amdsall bu Javandledbw ased it h itt.r adem I t descr arkibes s anhdow logos t o use are var t rad ious em ar t ools k s ort hat r egist areerpar ed t tof radt hem e ser ar kvsices of Sun dev elop Micr osy st ment em s,env I nc. ir on in ment t he Unit , deted ails Sttat hees, sup otpor hert coun f or XML t ries, in or Ent bot er pr h. ise COBOL, and p rov ides an ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em UNI X am is amrer egist t rad em ar kp rog of The Open pr ogr s anerded applicat ion ram m er s. Gr oup in t he Unit ed St at es an d ot her count r ies. SET, SET Secur Elect ic Tran ionm, ore and t tohe SET Logo e t r ad em ks ow ned sband y SET Secur e The second par te of t h eron book is g sact ear ed t he need s ofarapplicat ionardeveloper Elect ron ic Tr ansact ion LLC. ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d Ot h erapcom pan y,s.prFin oduct v ice ames m ay bim e tpr ort ademar s or serv ice tms ark s of ot hter new plicat ion ally,, and t h is ser book pr nesen t s some an t dkesign concep t o en able hes. r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n.

Preface This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS® or OS/ 3 90® , and how it can be ext en ded t o m oder nize leg acy applicat ions. I t p rov ides bot h a high - lev el discussion of t edof ar chit ect • ser v ice- or ien Table Content s ur e along w it h p r act ical, det ailed inf or m at ion ab out XML. •

I ndex

I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le By Franck Jose LuiswFern ra , ibes Dipak h Hore, Sanch Carmt ools ona t hat are par t of t h e ser v ices pr ogr amI snj ey, bu ndled it h andez it . I t Last descr ow David t o use varez ious dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov erPub v iew lish er: ofI BM t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em pr ogr d 2applicat ion p rog ram m er s. Pubam Datm e:er Jusnean 11, 00 3 I SBN: 0- 73 84- 26 15 -6

The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and Pages: 26 4 ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n. Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS I m plem ent solu t ions based on p r act ical ex amp les This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em pr ogr am m er s an d applicat ion p rog ram m er s. The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n.

The team that wrote this redbook This r edbook was pr oduced by a t eam of sp ecialist s fr om ar oun d t h e w or ld w or k in g at t h e I nt er nat ional Techn ical Su ppor t Or ganizat ion , Pough keepsie Cent er . •Fra nck I nj ey Table is aofPrContent oject sLead er at t h e I n t ern at ional Technical Sup por t Org anizat ion, •Poug hk eepsie. I ndex He has 2 5 year s exp er ience w ork ing on S/ 390 ® h ard w are and sy st em X MLfor onm z /ance. OS a ndBef OSor / 3e 9 0joinin : I nt roduct t o a SeFr r vi ce- Orw i ent chi te ctur e I T Ar chit ect in Fr ance. per g t heionI TSO, anck ase ad Ar Consult ing By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

Jose Lu is Fe rna nd ez Last ra is a z/ OS and OS/ 3 90 I n st ru ct or in I BM Lear ning Ser v ices Sp ain . He has 4 y ear s ex per ien ce in sy st em p rog r amm ing . He holds a Mast er s degr ee in Elect r onic lish er: I BM PhyPub sics f r om UC ( Univ ersidad de Cant ab ria) . His ar eas of exp er ience include sy st em applicat ion Pub e: Ju ne 11, Par 2 00 allel 3 dev elopDat ment and Sy splex® . I SBN: 0- 73 84- 26 15 -6

D ip akPages: H ore26is 4 a Senior Con su lt ant wit h West pac Ban king Corp ., Au st r alia. He hold s a Mast er s degr ee in Mat hem at ics fr om Delhi Univ ersit y , I ndia. He has m or e t han 25 y ears ex per ience in I T. His ar ea of exp er t ise ar e XML, com pon en t - based d ev elopm en t , pat t er ns, ap plicat ion ar chit ect ur e and e- bu siness app licat ions. His cur r ent f ocus is on use of XML in m odern izat ion of legacy syst em s. D a vi d S an ch ez Ca rm ona is a z/ OS and OS/ 3 90 in st ru ct or in I BM Lear ning Serv ices Sp ain. He Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 has 8 y ears of ex per ien ce in t h e MVS™ f ield. He holds a Mast er s d eg r ee in Com pu t ing Science fr om Desig UPM (nUncon iver sidsadforPolit ecnica de Madr id)ect . His ar on easz/of exp er t ise include st or age, z/ OS UNI X cept W eb ser v ices ar chit ur es OS Sy st em Ser v ices, Linu x in zSer ies® , W eb Serv er and WebSp here® Applicat ion Ser ver in z/ OS. I m plem ent solu t ions based on p r act ical ex amp les Than ks t o t h e follow ing people f or t heir cont r ibut ion s t o t his pr oject : This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of Rich Conw ay ,t ed Tam Holgerw it Wu Chin andler ser v iceor ien aras chitVilaghy ect ur e , along h pnder r actlich ical,, Alison det ailed for m at ion ab out XML. I nt er nat ional Techn ical Su ppor t Or ganizat ion , Pough keepsie Cent er I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed Ueli inst r W uctahli ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le Iprntogr er nat Technwical t Oribes ganizat Jose Cent er t hat are par t of t h e ser v ices amional s bu ndled it h Su it . ppor I t descr h owion t o, San use var ious t ools dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an Dav Booz, Ding is, Spher Kim Johnson, an Ser Joslin ov erid v iew of tMar he IkBM Web e App licatI vion v er,. Teddy This mTor at err es ial is of in t er est m ainly t o sy st em WebSph er e Ap plicat ion Serv er f or z/ OS and OS/ 39 0, I BM Pough keepsie pr ogr am m er s an d applicat ion p rog ram m er s. William G. Carey The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and zSeries Sy Softes w ara ecomp Desigr eh n, en I BM Pough keepsie ar ch it ect s. st I tem pr ovid siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d Michael D. Conn new ap plicat ion s.orFin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he En t er p rise Tooling, BMSOASantbaased Teresa or y . Th is in clu des an int r oduct ion t o t he I BM r ead er t o b uild r obuIst soluLabor t ions at r apidly Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by Ch risr act Laran sson cont d ser vice desig n. zSeries Sy st em Soft w ar e Desig n, I BM Pough keepsie Gar y Mazo WebSph er e zSer ies Tools developm ent , I BM Sant a Ter esa Lab orat or y Nick Tin dall App licat ion Developm ent , I BM Sant a Ter esa Lab orat ory Rob in Tan en baum WebSph er e D esign and Perf or m ance Analy sis, I BM Pou ghk eep sie

•

Table of Content s

•

I ndex

X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

Pub lish er: I BM Pub Dat e: Ju ne 11, 2 00 3 I SBN: 0- 73 84- 26 15 -6 Pages: 26 4

Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS I m plem ent solu t ions based on p r act ical ex amp les This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em pr ogr am m er s an d applicat ion p rog ram m er s. The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n.

Become a published author Join us f or a t wo- t o six - w eek r esid en cy pr ogr am! Help w r it e an I BM Red book dealing w it h specif ic pr odu ct s or solu t ions, w hile get t ing h ands- on ex per ien ce wit h leading - ed ge t echnologies. You' ll t eam w it h I BM t echnical pr of essionals, Business Part n er s an d/ or cust om er s. •

Table of Content s

•Your ef for t s w I ndex ill help increase pr odu ct accept ance and cust om er sat isfact ion. As a b onus, y ou' ll X ML elop on z / a OSn aetnd OSk/ 3of 9 0 :cont I nt roduct ionI tBM o a Se r vi ce- Or i ent Ar chi cturincrease e dev wor act s in developm ente dlab s, te and y our p rod uct ivit y an d m ar ket abilit y . By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

Find out mor e ab out t he r esidency p rog ram , br ow se t he r esidency ind ex , an d ap ply online at : Pub lish er: I BM Dat e: Ju ne 11, 2s/00residencies. 3 ib mPub .com / r edbook ht m l I SBN: 0- 73 84- 26 15 -6 Pages: 26 4

Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS I m plem ent solu t ions based on p r act ical ex amp les This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em pr ogr am m er s an d applicat ion p rog ram m er s. The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n.

Comments welcome Your com m ent s ar e im por t ant t o u s! We w ant our Redbook s™ t o be as h elpf ul as possib le. Send us you r comm ent s about t his or •ot her Red book Table Content s inofon e of t she follow in g way s: •

I ndex

X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e

Use t he online Cont a ct us r ev iew r edb ook for m f ound at :

By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

ib m .com / r edbook s Pub lish er: I BM

Send com ment s Pub Dat e: you Ju ner 11, 2 00 3

in an I nt er net n ot e t o:

I SBN: 0- 73 84- 26 15 -6

r ed book @us. ibm .com Pages: 26 4

Mail y our com m ent s t o:

I BM® Cor por at ion, I nt er nat ional Techn ical Supp ort Or gan izat ion Dept . HYJ Mail St at ion P0 99 Lev 24er 55age Sout XML h Road and XSL- based applicat ions on z/ OS and OS/ 39 0 Poug hk eepsie, NY 1 2601 - 54 00 Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS I m plem ent solu t ions based on p r act ical ex amp les This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em pr ogr am m er s an d applicat ion p rog ram m er s. The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n.

Part 1: XML on z/OS and OS/390 • •

I n t his par t w e pr ov id e a b rief ov er v iew of XML con cept s, an d descr ibe t he XML Toolk it for z/ OS and OS/ 3 90 and t he d ist r ibu t ed sam ple pr ogr am s. We also p rov ide an ov erv iew of XML andTable COBOL. of Content s I ndex

X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

Pub lish er: I BM Pub Dat e: Ju ne 11, 2 00 3 I SBN: 0- 73 84- 26 15 -6 Pages: 26 4

Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS I m plem ent solu t ions based on p r act ical ex amp les This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em pr ogr am m er s an d applicat ion p rog ram m er s. The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n.

Chapter 1. XML concepts This chap t er int r oduces basic XML concept s lik e DTDs, n amespaces, an d XML schem as. •

Table of Content s

•

I ndex

X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

Pub lish er: I BM Pub Dat e: Ju ne 11, 2 00 3 I SBN: 0- 73 84- 26 15 -6 Pages: 26 4

Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS I m plem ent solu t ions based on p r act ical ex amp les This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em pr ogr am m er s an d applicat ion p rog ram m er s. The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n.

1.1 XML introduction The id ea of univ ersal d at a f or mat s is not new . Pr ogr amm er s hav e been t ry ing t o find w ay s t o exchan ge inf or mat ion bet w een d if fer ent com pu t er pr ogr am s for a long t im e. St andar d Gener alized Mar k up Lang uage ( SGML) w as dev eloped t o ach iev e t his. SGML can be u sed t o m ar k •up dat a, t h atTable Content s ad at a in a way t hat allow s d at a t o be self- d escr ib ing . SGML is met ais, t oof add m et •langu age. I ndex X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e

The m arIknjup ocess invandez olv esLast u sin t agsHore, t o ident y pieces ofona inf or mat ion in a d ocu ment . Tags ar e By Franck ey, pr Jose Luis Fern ra , gDipak David if Sanch ez Carm nam es ( st r ings of char act ers) su rr ou nded by ar r ow br ack et s ( < and > ) . Ever y piece of dat a t hat is encoded will h ave a st ar t t ag an d an end t ag, for ex am ple, < t ow n> p at iy a< / t ow n> . The st ar t Pub lish er: I BM and end t ags mak e it easy f or soft w ar e t o pr ocess t he en cod ed inf or mat ion , as it clear ly Pub Dat e: Ju ne 11, 2 00 3 delineat es w here cer t ain p ieces of infor m at ion st art and w her e t hey end. I SBN: 0- 73 84- 26 15 -6

SGML Pages: d oes 26 n ot 4 p rescribe any par t icular m ar k up; inst ead , it d ef ines how any m ar ku p lan guag e can be for m ally specif ied. The m ost popu lar SGML app licat ion is HTML ( Hyp er t ex t Mar k up Lan guag e) , t he m ar ku p langu age t h at r ules t h e Web. The HTML sp ecificat ion is ow ned b y W3C. How ev er, diff erent br ow ser vend ors in t r oduced a nu mb er of in com p at ible t ags t o HTML, w hich ar e ou t sid e t he scope of t heLev origin al HTML specif icatbased ion s. These t ags eatz/ e OS p r oblem s f or er age XML and XSLapplicat ionscron and OS/ 39dev 0 elop er s w hen t hey au t hor Web pages because t hey m ust con sid er wh at b row ser w ill display t h e pages. And , alt houg h HTMLDesig has bneen er y ssuccessfu forv ices displayin in for m at convcept for W eb lser ar chitgect ur es onion z/ on OS br ow ser s, it w as not foun d t o b e usefu l in d escr ibing t he d at a t h at it r ep resen t s, m ean in g it did not hav e t h e met ad at a capab ilit y t hat isI messent ial fsolu or a t ions self- dbased escr ibing docum ent .les plem ent on pdat r actaical ex amp Fur mor e, SGMLdescr is q uit e inef w sh en is used cod3e90, comp d atita Thist her I BM Redbook ibes t he ficient u se of and XMLcum on Iber BMsom ser ev er r unitning z/ OSt oorenOS/ an dlexhow st r uct e. end Hened ce, t tohere ar ose need o develop a mI torperov light w eight m high ark up lang uage,ssion so W3C can beurext m odern izealeg acy t applicat ions. ides bot h a - lev el discu of dev t het ed spar ecificat ion XML w ( eXt Mardet k up Lanin guag XMLabisout simXML. ilar t o SGML in ser velop ice- ed or ien chit ect ur eforalong it h ensible p r act ical, ailed for me)at. ion t hat it p r eserv es t he not ion of general m ar k up . Th er e ar e v er y f ew opt ion al feat ur es, and m ost I n addit SGML f eat ionurt o esan t hat ov erv weriew e deemed of XML dif concep ficult t ts,o tim heplem f irst ent parhav t of et hbeen e book dr opped. p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an 1.1.1 Document-centric versus data-centric XML ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em pr ogr am m er s an d applicat ion p rog ram m er s. Ther e ar e t w o b road ap plicat ion ar eas of XML t echn ologies. Th e fir st r elat es t o d ocu ment - cent r ic app ions,par antdoft he t ogdat r ic tapp licat ions. Thapplicat e documion entdeveloper - cent r ic applicat The licat second t h esecond book is earaedcent m ore o t he need s of s and ion out p ut s ar e p rim ar ily meant f or hum an consum pt ion. Som e ex am ples of such d ocu m (en t s aran e d ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re SOA) legal br iefs, m anu als, pr oduct cat alog s, and so for t h . The k ey elem ent of t hese d ocu m en t s is Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d sem stplicat r uct urion eds.mFin ar kally ed -,up t ext . new i-ap t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Dat r ic eXML is usedas t owmell ar as k up higbhly st ru ur ed inf or mat ion st ru es inbya Pat taercent ns f or business, XMLased mct essage d esign, andsuch t he pas r indat cipales of ctd ur esign pr ogr am m ing langu age, r elat ional dat a fr om dat abases, f inancial t r ansact ions an d t h e like. cont r act an d ser vice desig n. Dat a- cent r ic XML is t y pically generat ed by m achines an d is meant for machin e consum pt ion. XML's ab ilit y t o nest an d r epeat m ar k up m akes it a per fect choice f or r ep resen t ing t hese t y pes of dat a. Wit h t he int r od uct ion of XML Schem a, w e ar e now able t o add dat a t yp e at t r ibut es t o t he t ags, w h ich m akes d at a- cen t ric XML a v er y p ower fu l m ech anism t o r epr esent ent erp rise d at a, esp ecially for dat a ex change and e- business. For t he pur pose of t h is book , w henever w e r efer t o XML, it is un derst ood t o m ean dat a- cent r ic XML only .

1.1.2 XML definitions XML is a sy st em - ind ep en dent st andar d for t he r epr esent at ion of dat a. XML is not just som e n ew v er sion of HTML; it is dif fer en t f rom HTML. Like HTML, XML h as t ags, and in t hese t ags it encloses dat a. The d iffer ence is t hat HTML uses it s t ags t o display t h e enclosed t ext , and t hese t ags are st an dar d and fix ed . •I n XML you can Table Content crof eat e t he st ags y ou w ant , w it h only a sm all n um ber of r est r ict ions, and t h ese •t ags w ill be used I ndex by a p r ogr am ( par ser ) t o p rocess t he d at a enclosed bet w een t h em . X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e

Ex am ple 1- 1 sh ows a simp le XML docum ent . By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David

Sanch ez Carm ona

ExaPubmlishpler:e I BM 1 - 1 . An XM L docu m en t Pub Dat e: Ju ne 11, 2 00 3 I SBN: 0- 73 84- 26 15 -6 Pages: 26 4



Lev er age XML and XSLbased applicat ions on z/ OS and OS/ 39 0

Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS David I m plem ent solu t ions based on p r act ical ex amp les Sanchez Carmona This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it 20 can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML.

I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices Luis dev elopJose ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em Fernandez pr ogr am m er s an d applicat ion p rog ram m er s.Lastra The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d

Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by A client it hd his W eb desig br own. ser cou ld f ill out a f orm , en t er ing t he nam es of t he em ploy ees he cont r act wan ser vice w ant s t o add or d elet e. The dat a cou ld t h en be sent t o a Web applicat ion t h at could pr ocess t he XML docum ent and ext r act t he dat a, gener at in g t he n ecessar y up dat es, for ex am ple, on a DB2 ® t able. As t h is ex am ple illust r at es, t h e r ules ar e ver y few : each t ag mu st hav e an enclosin g t ag , and not m uch mor e. The t ags ar e inv ent ed t ags, w hich means t hat t hey ar e fr ee- for m . Text is syst em - independ en t , and since XML is v er y f lex ible and is b ased only on t ext , it is u sed as t he main w ay t o t r anspor t d at a b et w een d iffer ent en vir onm ent s. Of t en, XML docum ent s are aut om at ically g en er at ed by t ools, and in m any sit uat ions we need

t hese XML docum ent s t o f ollow ru les w e cr eat e. We use ot h er docum en t s, cont aining XML dat a defin it ion s in wh ich w e specif y our rest r ict ion s, t o accomp lish t his. The m ost wid ely u sed r ules lan guag e is Docum ent Typ e Definit ion ( DTD ) , descr ibed in 1. 2, " Docum ent t y pe def in it ion " on pag e 8. XML Schem a is anot her r ules langu age t h at aim s t o pr ov id e m ore com plex sem an t ic r ules. I t also int r odu ces n ew sem ant ic capab ilit ies, such as su ppor t for n amespaces and t y pe- check ing w it hin • Table of Content s an XML docum ent . XML Schem a is d escr ib ed in 1. 4, " XML Schem a" on p age 13 . •

I ndex

X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

1.1.3 Document validity and well-formedness Pub lish er: I BM

XML is r em iniscen t of HTML since t hey ar e b ot h d er iv ed f rom SGML, w hich w as d ef ined in 19 86. Datee:HTML, Ju ne 11,XML 2 00 3 t ags id en t ify t h e dat a, rat h er t han specif ying h ow t o disp lay it . Wher e an But Pub un lik I SBN: 073 8426 15hing -6 HTML t ag says som et like " display t his d at a in bold fon t " ( < b > .. . < / b> ) , an XML t ag act s lik e 4 y our p rog ram . I t pu t s a label on a piece of d at a t h at id en t ifies it ( f or exam ple: a f ieldPages: nam e26in < m essage> .. . < / m essage> ) . Th is is t he f irst of a nu mb er of diff er ences bet w een t he lan guag es. XML docum ent s can be w ell- for m ed , or t hey can b e w ell- for m ed an d v alid. Th ese ar e t w o ver y im por t ant r ules t hat do n ot ex ist for HTML docum en t s. These iron - clad r ules cont r ast w it h t he m or e fr ee- st y le nat u re of a lot of t he concep t s in XML. The r ules can b e defined br iefly as followLev s: er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS A w ell- for m ed d ocu ment car ries out t he basic design r ules f or XML docum ent s. I m plem ent solu t ions based on p r act ical ex amp les A v alid docum en t r espect s t he r ules w r it t en in it s DTD. This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it A d ocu m en t m ight be well- for m ed b ut st ill n ot b e v alid . Ex am ple 1- 2 sh ows a DTD w hile can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of Ex am ple 1- 3 sh ows a sam ple XML docum ent . ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. I n addit Exa m pl ione t o 1 -an 2 .ovDTD erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov er v iew of BANCO t he I BM(TARJETA+)> Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em

The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ch it ect s. I tNom pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d

Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicatCod_Cuenta ion s. Fin ally , ((#PCDATA)> t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he

Silvia

2562789452

•

Table of Content s

The d ocum enI ndex t show n in Ex am ple 1- 3 is well- for m ed, bu t it is not valid accor din g t o t he sam ple • DTD show n in 1-roduct 2 b ecau < ceNOM> ischi not d efeined in t h e associat ed D TD ( t ags X ML on z / OS a ndEx OSam / 3 9ple 0 : I nt ion se t o at he Se r vi Or i entteag d Ar te ctur ar e case sensit ive) . By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

These exam ples illust r at e t he d iff er ence bet w een w ell- f or medn ess an d v alidit y : Pub lish er: I BM Pub Dat e: Ju ne 11, 2 00 3

Docum ent s t hat ad her e t o r ules described in t he associat ed DTD or XML Schema ar e v alid . I SBN: 0- 73 84- 26 15 -6

Pages: 26 4 s t hat car r y out t he sy nt act ical r ules for XML d ocu m en t s ar e w ell- f orm ed. Th ese Docum ent r ules hav e t o do w it h at t r ibut e nam es, wh ich should be uniqu e w it hin an element , and at t r ibut e valu es, w hich m ust n ot cont ain t he ch aract er < , an d so on.

All of t h e con st raint s ar e defined in t he XML 1. 0 r ecom m en dat ion. For mor e inf or mat ion r efer t o t he follow in g Web sit e: Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 ht t p: / / w w w . w3 . org / XML Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS Det erm inin g w h et h er a par t icular d ocu ment is in com p lian ce w it h t h ese r ules is a t wo st ep pr ocess. Well-ent for m edtness insur eson t hat XML sw ill be ab le t o r ead t he docu ment , validit y I m plem solu ions based p r act icalpar exser amp les det er min es w h et h er an XML d ocu m en t ad heres t o a DTD or schem a. An XML applicat ion will This I BM check for Redbook an d r ejectdescr d ocuibes m ent he t s tuhat se of ar eXML not on w ellI BM f orm sered v erbefor s r unening check z/ ing OS w orhet OS/ her 3 90, t h ey ancom d how ply it can w it h be validit ext end y const ed t or aint m odern s ( VCs) ize. leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogrTip am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an a tsyst t estSpher ed, v e alid it ylicat check t ur m n ed offialt oisim perfmorainly man tce. ov er vAft iewer of he Iem BMisWeb App ioning Sercan v er .be This at er ofprinove t er est o sy st em pr ogr am m er s an d applicat ion p rog ram m er s. The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n.

1.2 Document type definition A d ocu m en t t y pe d ef init ion, or DTD, sp ecifies t he kind s of t ags t hat can be in clu ded in y our XML docum ent , t he v alid ar r angem ent s of t h ose t ags, and t h e st ru ct u r e of t he XML d ocu ment . The DTD defin es t he t y pe of element s, at t rib ut es, and ent it ies allow ed in t h e docum ent s, an d m ay •also specif y some Table of Content s t o t h eir ar r ang em ent . You can use t he DTD t o m ak e su r e you don 't lim it at ions •creat e an invIalid ndex XML st r uct u re since t h e DTD defin es h ow elem ent s r elat e t o one anot h er w it hin X ML docum on z / OSen a nd / 390 nt roduct a Sealso r vi ce-uOr i ent chi te ctur t he t 'sOS t ree st: rI uct ur e. ion Yout ocan se it etdo Ar define whe ich at t r ibu t es can be used t o defin e an enLuis t anFern d wandez h ichLast ones ar e not By Franck I nj elem ey, Jose ra , Dipak Hore,allowed. David Sanch ez Carm ona I n ot her w or ds, a D TD d ef ines our ow n lang uage f or a sp ecific ap plicat ion . Pub lish er: I BM

Datcan e: Ju ne 00 3 st or ed in a separ at e f ile or emb ed ded w it h in t h e same XML file. I f it is ThePub D TD be11, eit2her I SBN: 073 8426 -6 it m ay be shar ed w it h ot h er d ocu m en t s. st or ed in a separ at e15file Pages: 26 4

XML docum ent s r efer encin g a DTD w ill cont ain a < ! DOCTYPE> declar at ion, w h ich eit her cont ains t he en t ire D TD d eclar at ion if t h is is t he case of an int er nal DTD , or specif ies t he locat ion of an ext er nal DTD. Ex am ple 1- 4 sh ows an ex t ern al DTD in a f ile n amed DTD-Agenda.dtd.

Exa m pl e 1 - 4 . An e xt e r n al DTD Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS

I m plem ent solu t ions based on p r act ical ex amp les

This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of

ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML.

I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le

pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an

ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em pr ogr am m er s an d applicat ion p rog ram m er s.

The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and

comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d

Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n. Ex am ple 1- 5 is an XML d ocu ment t h at r efers t o t h is ex t er nal D TD.

Exa m pl e 1 - 5 . Re fe r en ce t o an e x t er n a l D TD





Matutano Gerente • •

Table of Content s

Pepe Montilla I ndex

X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e

912563652

By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

658968574 Pub lish er: I BM

256 Pub Dat e: Ju ne 11, 2 00 3 I SBN: 0- 73 84- 26 15 -6

Pages: 26 4

We can also define an in t er nal DTD in a XML docum ent so t hat bot h of t h em ar e in t he sam e f ile. z/ OS Ex amLev ple er 1-age 6 shXML ows and t his XSLcase.based Not iceapplicat t h at inions any on case, intand er nalOS/ or 39 ex0t ern al DTD, t he < ! D OCTYPE> declarat ion ind icat es w hat t he root elem ent is. Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS

Exa m e 1ent - 6 .solu Ant ions in tbased e r na lonDTD I mpl plem p r act ical ex amp les This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ienRAIZ t ed ar[chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML.

it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices

Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em

The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ]>ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he

r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat . t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n. . .

An XML docum ent is not r equ ir ed t o h ave a DTD. DTDs p rov ide p arser s w it h clear inst r uct ions on w hat t o check for w hen t hey are det er m ining t h e validit y of an XML d ocu ment . DTDs or ot her

m ech anism s, lik e XML schem as, cont r ibut e t o t h e goal of ensur ing t h at t h e applicat ion can easily det er min e w het her t he XML docum en t ad heres t o a g iv en set of ru les, b ey ond t he wellfor m edness r ules defined in t he XML st and ard . DTDs are also used by t ools t o cr eat e XML docum ent s. Hav in g t he logical d ef init ion of an XML f ile st or ed separ at ely allows for t h e r esult in g D TD t o be shar ed acr oss org anizat ions, ind ust r ies, or t he Web. W hen b uilding XML app licat ions, it is pr obab ly a g ood idea t o look f or exist ing DTDs t hat mig ht su it y our p ur pose. As XML becomes • Table of Content s m or e popu lar, mor e com m er cially an d in dust r ially orient ed applicat ions w ill lik ely ap pear, and • I ndex st andar d s w ill em er ge. For m ore in for m at ion on t h e lat est em er ging XML st andar d s r ef er t o t h e X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e follow ing Web sit e: By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

ht t p: / / w w w . oasis- open. or g Pub lish er: I BM Pub Dat e: Ju ne 11, 2 00 3

DTD Icontents SBN: 0- 73 84- 26overview 15 -6 Pages: 26 4

The p ur pose of a DTD is t o def in e t he valid building b lock s of an XML docum ent . I t defines t h e docum ent st ru ct ur e w it h a list of accept ab le elem en t s. Seen fr om a DTD point of v iew , all XML docum ent s ( and HTML docum en t s) ar e m ade u p of t he f ollow ing simp le buildin g b lock s: Ele m en t s Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 I n a DTD , XML elem en t s ar e declared w it h a DTD elem ent declar at ion. Th e syn t ax of t his Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS declarat ion is: I m plem ent solu t ions based on p r act ical ex amp les contents)> This I pr ogr Un día en la vida de un &ovni;

P ar am e t er e nt i t ie s Par am et er ent it ies ar e used wit h in t h e DTD it self . Their declar at ion dif fer s by t h e inclusion of t he % char act er . An ex amp le of t his declarat ion is as f ollow s:

X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e

By Franck I nj ey, Jose Luis andez Last ra , Dipak Hore, David Sanch ez Carm ona Pub

Pub Dat e: Ju ne 11, 2 00 3

I SBN: 0- 73 84- 26 15 -6

Pages: 26 4

N ot a t ion s Not at ions are uand sed XSLt o refer t o dat a fr om anon ouz/ t sid ( non-OS/ XML) Lev er age XML based applicat ions OSe and 39 0sou rce. They p rov ide a basic m ean s by w h ich non - t ext u al inf orm at ion can b e han dled w it hin a docum en t . An exam ple of tDesig he use n con of tcept his ds eclar for W ateb ionser is vas ices follow ar chit s: ect ur es on z/ OS I m plem ent solu t ions based on p r act ical ex amp les

acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of

I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t(#PCDATA)> he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le

ise COBOL, and p rov ides an

am m er s an d applicat ion p rog ram m er s. The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and Kelly Brown ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead erCOMM t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM EN TS Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act d ser vice I t isan p ossible t o desig inser tn.any com m en t as show n in t he f ollowin g:

ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices

pr ogr am m er s an d applicat ion p rog ram m er s. Greeting The second par t of t h e book is g ear ed m ore t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d

Words ofesgreeting:
Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t hselect="greeting"/> is book pr esen t s some im p ort an t d esign concep t s t o en able t he output.txt for st an da Levt herisage and applicat andmOS/ 39 0 or command1 2> errors.txt f or st and ard er ror out pu t . Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS plem ent solu t ions based 3.1.2I mDOM samples

on p r act ical ex amp les

This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. ASBuilder I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed The ild er p r e-t he p arses a OS docum s and alidat ance tdocu mentles agains inst rASBu uct ions f orsam instple alling XML XML Toolksch it f em or z/ andent OS/ 39 0 vV1. 4 anes d inst ru nning h e samp sch em a gr am mar s. I t can be used t o ch eck if y our n ew schem as ar e w ell for m ed , and ch eck if y o pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e sertvoices docum ent s ar e v alid for t h ese schem as. You can t hink about it as a DOM er ror hand ler sk dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ideselet an on m o DOM par ser: y ou can use it as a b asis f or y our n ew er r or han dlers, an d it show s y ou t he f eat res y o ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy stuem act ivat e t o d o XML v alid at ing w it h schem as. pr ogr am m er s an d applicat ion p rog ram m er s. You w ill pr obably t o upd t he in alt of ile some point . So, ion t o pdeveloper reserv e its, and w e h ave cop ied The second par t ofwtan h et book isatgeear edorig m ore t heatneed s of applicat sam ple fr om it s origin al dir ect or y t o a n ew one cr eat ed for t his pu r pose. We did t his it h t he ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re w ( SOA) anfollow d seq uence of comm an ds: Web ser vices, and descr ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by mkdir /u/david/samples (where david was our userid) cont r act an d ser vice desig n. mkdir /u/david/samples/java mkdir /u/david/samples/java/dom cp /usr/lpp/ixm/IBM/xml4j-4_0/samples/dom/ASBuilder.java /u/david/samples/java/dom/ASBuilder.java

We can now w or k w it h our n ew / u/ d avid/ sam ples/ jav a/ dom / ASBuilder . jav a f ile, m ak ing changes t o code w hile st ill pr eser v ing t he or iginal ver sion . The b est w ay t o d o t h e upd at es is t o r enam e t h e Jav because in you r CLASSPATH you hav e an ASBuilder class already , an d it is a g ood id ea t o p reserv e her e w e ar e going t o w ork wit h t h e or ig inal v ersion of t he ASBuilder class. We can t est wh et her our v ariab le is cor r ect and has t his class in vok ing it w it h out an y par am et er . We do t his by ent er ing t he com man d: •

Table of Content s

•

I ndex java dom.ASBuilder X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

I f wPub e see ASBu lish er: I BM ild er sour ce, w e can f ind a p ack age declar at ion t hat point s t o dom , so t his is t h e r eas t o en t er dom . ASBu ild er . Th e r esult is show n in Figur e 3- 1 . Pub Dat e: Ju ne 11, 2 00 3 I SBN: 0- 73 84- 26 15 -6 Pages: 26 4

Figu r e 3 - 1 . dom .ASB ui lde r

Lev er age XML and XSL- based applicat ions on z/ OS and OS/ 39 0 Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS I m plem ent solu t ions based on p r act ical ex amp les This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML. I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst f or it ur f ore z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le Wit hr uct parions am et er inst - f yalling ou cant he actXML iv at eToolk a feat called http://apache.org/xml/features/validatio pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t huereser v ices full-checking; t his is t he sp ecial URI f or t he feat ur e. When t urt hat ned are on, par t hist of feat enab les Sch em dev elop ment env ir on ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides check ing f or addit ion al err or s t hat ar e t im e- con su min g or mem or y- in t en siv e. I t d oes n ot afan fect t h e ov er vpiew ofmt he BMd Web Spherinst e App licatt ion er . Thisa m erm ialariss. of in t er et est ainly t o of syf st em che level er for ed Ion ocu ment ances hat Ser usevSchem grat am Param erm- F t ur ns t his pr ogr am m er s an d applicat ion p rog ram m er s. By def ault t h is feat ur e is of f sin ce it af fect s perf or m ance. The parst for of tat h eleast bookt w isog par ear amet ed m er ore of applicat s and This second class w ait s. tIof yt he ou need w rit es few er t han ion t w odeveloper p aram et ers, t he pr ogr am s ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v iceor ient ed ar chit ect u an dDOM t he pr ev ious scr een again. We ar e going t o mak e a file w it h a sam ple XML Schemaret o( SOA) t est t his Web ser vices, and descr ibes in det ail some ser vicebased t op ologies for b ot h legacy sy st em s de a w e can use it as t he second p aram et er. To do t his, w e cr eat e a dif fer en t d ir ect or y w here w e cran eat new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA- b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act/u/david/samples/java/schemas an d ser vice desig n. mkdir oedit /u/david/samples/java/schemas/zOSXML.xsd

in t his f ile w e h ave en t er ed t he cont ent s sh ow n in Ex am ple 3- 1.

Exa m pl e 3 - 1 . ou r sa m p le XM L Sche m a



X ML on z / OS a nd OS / 3 9 0 : I nt roduct ion t o a Se r vi ce- Or i ent e d Ar chi te ctur e By Franck I nj ey, Jose Luis Fern andez Last ra , Dipak Hore, David Sanch ez Carm ona

Pub

Pub Dat e: Ju ne 11, 2 00 3 I SBN: 0- 73 84- 26 15 -6 Pages: 26 4



Lev er age Desig n con cept s for W eb ser v ices ar chit ect ur es on z/ OS

I m plem ent solu t ions based on p r act ical ex amp les

This I BM Redbook descr ibes t he u se of XML on I BM ser v er s r un ning z/ OS or OS/ 3 90, an d how it can be ext end ed t o m odern ize leg acy applicat ions. I t p rov ides bot h a high - lev el discu ssion of ser v ice- or ien t ed ar chit ect ur e along w it h p r act ical, det ailed in for m at ion ab out XML.

I n addit ion t o an ov erv iew of XML concep t s, t he f irst par t of t h e book p r ovides d et ailed inst r uct ions f or inst alling t he XML Toolk it f or z/ OS and OS/ 39 0 V1. 4 an d ru nning t h e samp le pr ogr am s bu ndled w it h it . I t descr ibes h ow t o use var ious t ools t hat are par t of t h e ser v ices

ment , det ails t he sup por t f or XML in Ent er pr ise COBOL, and p rov ides an ov er v iew of t he I BM Web Spher e App licat ion Ser v er . This m at er ial is of in t er est m ainly t o sy st em pr ogr am m er s an d applicat ion p rog ram m er s. The second par t o t he need s of applicat ion developer s and ar ch it ect s. I t pr ovid es a comp r eh en siv e int r odu ct ion t o ser v ice- or ient ed ar chit ect u re ( SOA) an d Web ser vices, and descr

ibes in det ail some ser vice- based t op ologies for b ot h legacy sy st em s an d new ap plicat ion s. Fin ally , t h is book pr esen t s some im p ort an t d esign concep t s t o en able t he r ead er t o b uild r obu st SOA b ased solu t ions r apidly . Th is in clu des an int r oduct ion t o t he I BM Pat t er ns f or e- business, as w ell as XML- b ased m essage d esign, and t he p r in cip les of d esign by cont r act an d ser vice desig n.