1. z/Ware 2.0 Technical Overview
illustro Systems International
A Division of UNICOM Global

2. Topics z/Ware Common Components (ZWC) Combined Products
Enhanced Script facilities
Named Scripts
Document facility
Executing CICS programs
COMMAREA Events
HTTP Client facility
WebService Client facility
Batch Program API

3. z/Ware Common Components Infrastructure (ZWC)
Common support services split from previous product code to create a new infrastructure that can support multiple products
Allows multiple products to run in a single address space
Simplifies the code of each product
Multiple products receive benefit of support and enhancement

4. ZWC… Services Multi-tasking workflow management
Communications management
Message routing, logging, storing, retrieval
Operator commands
Operating system interfaces
Storage management
Dump/trace management
3270 session management
Variable/value management

5. ZWC… Services Document management File and Library management
Read/write/caching
HTTP Server
HTML & XML support
Static document serving
CGI program execution
Web services (SOAP) support

6. ZWC…

7. z/Ware Product Functions Combined
z/Ware 2.0 performs the functions previously handled by z/Web-Host and z/XML-Host
Supports XML templates in addition to HTML
Support Web Services (SOAP) requests and responses

8. Enhanced Script Facilities
Statements previously used with the Application Automation Facility (AAF) within a WebScreen definition, are now refered to as Scripts
Expanded to a more feature rich scripting facility
Can be used in places other than a WebScreen

9. Enhanced Script Facilities...
Many new facilities in Version 2 use new script statements to perform important functions
Several of the old statements have been expanded to work with new facilities If
Assign

10. Execution of Named Scripts
A new facility called Named Scripts allows execution of stand alone scripts
Script statements stored in a library member and defined to the system with a script name
Not associated with a 3270 session
Requested from web page or off-platform program with any desired user variables
Use any available scripting functions
Requests can be one-time or persistent

11. Execution of Named Scripts...

12. The Document Facility
The Document script statement is used to create and delete in-storage user documents
Documents are created from templates stored in library members
Substitution of user variable values within the template
Templates can contain HTML, XML or any desired text format
Documents can be returned to the requestor, placed in a COMMAREA or used for other purposes

13. The Document Facility…

14. Executing CICS COMMAREA Programs
Script statements can be used to:
Create named CICS COMMAREA buffers
Map data fields within the COMMAREA
Insert required data into the COMMAREA
Request execution of a CICS program passing the COMMAREA
Extract data from returned COMMAREA
Create a user Document with returned data

15. Executing CICS COMMAREA Programs...
Multiple CICS regions can be defined and requests directed to desired region
Can use
Generic or specific CICS connection
Any desired mirror transaction id
Any desired userid
Persistent Script requests can be used to perform multiple requests using the same data items

16. Executing CICS COMMAREA Programs...

17. CICS COMMAREA Events
A COMMAREA Event is triggered by a user CICS program passing a COMMAREA to a z/Ware CICS program
The COMMAREA data is matched against the defined COMMAREA Event definitions
Script statements from the matching COMMAREA Event are executed
Updated COMMAREA is returned to original program

18. CICS COMMAREA Events…

19. HTTP Client Support
Scripts can send GET or POST HTTP requests to external servers
Servers in the data center
Servers anywhere on the Internet
Can be used to send data to remote servers or retrieve data from remote servers
Documents are created by user and used for:
The URL
Data (on post requests)
Custom HTTP request headers (optional)

20. HTTP Client Support…
External servers are defined in the ZWC configuration via Define_Server statement
The request is sent using the HTTP_Request script statement
HTTP response headers are returned in the Document named HTTP_RESP_HDRS
HTTP response data is returned in the Document named HTTP_RESP
User variables set by request:
HTTP_RETURN 0 or numeric error code
HTTP_STATUS numeric HTTP result code
HTTP_RESPONSE character HTTP result string

21. HTTP Client Support…
Script If statement can test “fields” in returned Document against character strings
Script Assign statement can extract data “fields” from returned Document into user variables

22. HTTP Client Support…

23. Web Service Client Support
Can invoke a Web Service residing anywhere on the Internet
Called Type1 service because it is not fully automated yet
Documents created by user script & used for:
URL data
SOAP Body data (XML elements sent as request)
Automatically built:
Server part of the URL string
SOAP Envelope

24. Web Service Client Support…
External servers are defined in the ZWC configuration via Define_Server statement
The request is sent using the WebService_Type1 script statement
HTTP response headers are returned in the Document named HTTP_RESP_HDRS
SOAP response data is returned in the Document named HTTP_RESP (XML response document)

25. Web Service Client Support…
User variables set by request:
SOAP_RETURN 0 or numeric error code
HTTP_STATUS numeric HTTP result code
HTTP_RESPONSE character HTTP result
Script If statement can test data “fields” from returned documents
Script Assign statement can extract data “fields” from returned documents into user variables

26. Web Service Client Support…

27. Batch Program API Extends the CICS COMMAREA concept to batch programs
Allows simple program call to trigger script execution
No TCP/IP Sockets programming
Batch programmer does not have to know anything about TCP/IP, HTTP, SOAP, Web Services or other protocols
User program builds COMMAREA (buffer) containing needed data
Program call to ZWEBBAT1 passing COMMAREA

28. Batch Program API… COMMAREA Event script triggered in z/Ware Server
Script performs desired processing
Updated COMMAREA returned to user program
REXX external function provided
Place COMMAREA data on program stack
Call ZWEBREXX() function
Updated COMMAREA data returned on program stack

29. Batch Program API…

30. Wrap Up More is planned for future releases of Version 2
Please let us know if you have specific needs