Enhancing MCP Applications Through Language Integration. MCP 3030 Dan Meyer, Consulting Engineer May 15, 2012

Transcription

1 Enhancing MCP Applications Through Language Integration MCP 3030 Dan Meyer, Consulting Engineer May 15, 2012

2 Agenda A Little History Opportunities & Examples Discussion 2012 Unisys Corporation. All rights reserved. 2

3 History

4 Legacy Language Integration 2012 Unisys Corporation. All rights reserved. 4

5 Woo Hoo LIBRARIES Here I come to save the day! That means that Mighty Mouse is on the way! 2012 Unisys Corporation. All rights reserved. 5

6 And CONNECTION Libraries Never fear, UNDERDOG is here! 2012 Unisys Corporation. All rights reserved. 6

7 Along with STRUCTURE BLOCKS Call for Super Chicken Block, block, block, BLOCK!!! Don t forget his faithful companion, Fred! 2012 Unisys Corporation. All rights reserved. 7

8 Language Integration Opportunities With a few Examples 2012 Unisys Corporation. All rights reserved. 8

9 WEBAPPSUPPORT APIs Regular Expressions XML Parser HTTP Client Applications Applications WEBPCM Support XML Parser HTTP Client Regular Expressions Misc PCRE WEBAPPSUPPORT JPM JPM JProcessor WEBAPPSUPPORT Application Programming Guide 2012 Unisys Corporation. All rights reserved. 9

10 Native Interfaces (JNI) From to COBOL/ALGOL Application Library JNI Library Application Connection From COBOL/ALGOL to Worker Worker Proxy C++ DLL Class JVM JProcessor Application JNI Interfaces JNI Proxy Lib Worker Worker Class JVM JProcessor Native Interface for MCP See *JREDOC with MCPJAVA Software 2012 Unisys Corporation. All rights reserved. 10

11 Language Integration Opportunities WEBAPPSUPPORT 2012 Unisys Corporation. All rights reserved. 11

12 HTTP Client API Client HTTP API for COBOL and ALGOL Application makes HTTP requests WEBAPPSUPPORT handles the network send & receive Application processes the response Object-oriented interface Host object: hostname/ip address, port number Client object: cookie handling, credentials Socket object: socket attributes, e.g., SSL Request object: HTTP method, URL, query string Compressed content Encrypted sessions 2012 Unisys Corporation. All rights reserved. 12

13 Regular Expressions (RegEx) API A regular expression is a special text string for describing a search pattern, i.e., wildcards on steroids address regular expression: \b[a-z0-9._%+-]+@[a-z0-9.-]+\.[a-z]{2,6}\b 2012 Unisys Corporation. All rights reserved. 13

14 RegEx Uses Verifying and sanitizing data to avoid SQL injection vulnerabilities Highlighting text in output ERROR WARNING Parsing input commands Validate -v, <server number> - <server number> private static String reqex = "([0-9]+)" + // starting digits "(?:\\s*\\-\\s*([0-9]+))?" + // optional - end "\\s*(\\,)?\\s*" + // optional comma " ([^0-9\\s].*) ; // anything else 2012 Unisys Corporation. All rights reserved. 14

15 Creating RegEx Strings Unisys Corporation. All rights reserved. 15

16 Using RegularExpressions with COBOL 1. Compile the expression / pattern 2. Execute the expression against a subject string STRING \S+ DELIMITED BY SIZE INTO PATTERNDOC WITH POINTER PATTERN-POINTER. CALL COMPILE_RE_PATTERN OF WEBAPPSUPPORT USING PATTERNDOC, PATTERN-START, PATTERN-LENGTH, PATTERN-TAG, ERROR-CODE, ERROR-TEXT GIVING WEB-RESULT. MOVE <input string> TO SUBJECT. MOVE <input string length> TO SUBJECT_LENGTH. CALL EXECUTE_RE_PATTERN OF WEBAPPSUPPORT USING PATTERN-TAG, SUBJECT, SUBJECT-START, SUBJECT-LENGTH, NUM-SUBSTRINGS, SUBSTRING-OFFSETS, SUBSTRING-LENS, MAX-SUBSTRING-LEN, SUBSTRING-BUFFER GIVING WEB-RESULT Unisys Corporation. All rights reserved. 16

17 XML Parsing DOM Parser Document Object Model Operates on the document as a whole Processes objects SAX Simple API for XML Sequential access parsing Operates each piece of XML sequentially JDOM integration of DOM and SAX 2012 Unisys Corporation. All rights reserved. 17

18 MCP XML Parser XML document source from File, URL, Array Read specific data in an XML document Read data sequentially in an XML document Modify a parsed XML document Transform an XML document into a new XML document Create XML documents 2012 Unisys Corporation. All rights reserved. 18

19 Creating XML documents Easy with COBOL85 STRING or ALGOL REPLACE STRING "<?xml version=""1.0"">" "<PRODUCT>" "<NAME>Widget</NAME>" "</PRODUCT>" DELIMITED BY SIZE INTO TEMP_DOCUMENT WITH POINTER XML-POINTER. SUBTRACT 1 FROM XML-POINTER GIVING XML-LENGTH. Not in the correct character set translation required CALL "ENCODE_UTF8 OF WEBAPPSUPPORT" USING CCS-EBCDIC, TEMP_DOCUMENT, XML_LENGTH, XML_DOCUMENT, XML_LENGTH GIVING WEB-RESULT Unisys Corporation. All rights reserved. 19

20 Merge Data using XML Templates Fairly static XML document - use the Merge Data feature Example template: <?xml version="1.0"> <PRODUCT> <NAME>$REPLACE=NAME</NAME> <PARTNUM>$REPLACE=PARTNUM</PARTNUM> <PRICE CURRENCY="USD">$REPLACE=PRICE</PRICE> </PRODUCT> 2012 Unisys Corporation. All rights reserved. 20

21 Merge Data using XML Templates $REPLACE markers get replaced with data: 01 NAME-VALUE-BUFFER. 03 NAME-VALUE-PAIR OCCURS 20 TIMES. 05 NAME-FIELD PIC X(30). 05 VALUE-FIELD PIC X(200). MOVE "INPUT/""PRODUCTTEMPLATE.XML""" TO FILE-NAME. MOVE "NAME" TO NAME-FIELD (1). MOVE "Widget" TO VALUE-FIELD (1). MOVE "PARTNUM" TO NAME-FIELD (2). MOVE "1234" TO VALUE-FIELD (2). MOVE "PRICE" TO NAME-FIELD (3). MOVE "7.99" TO VALUE-FIELD (3). MOVE 3 TO NUM-PAIRS. CALL "MERGE_FILE_AND_DATA OF WEBAPPSUPPORT" USING CHARSET-EBCDIC, NO-STRING-TERM, FILE-NAME, NAME-VALUE-BUFFER, NUM-PAIRS, NAME-WIDTH, VALUE-WIDTH, TRIM-BLANKS, HTML-BUFF, HTML-PTR GIVING WEB-RESULT Unisys Corporation. All rights reserved. 21

22 Merge Data using XML Templates Results: <?xml version="1.0"> <PRODUCT> <NAME>Widget</NAME> <PARTNUM>1234</PARTNUM> <PRICE CURRENCY="USD">7.99</PRICE> </PRODUCT> 2012 Unisys Corporation. All rights reserved. 22

23 Create XML From Scratch Making procedure calls to build node-by-node Create an empty XML document CALL "CREATE_XML_DOCUMENT OF WEBAPPSUPPORT" USING DOC-TAG, DECLARATION, DOC-NODE GIVING WEB-RESULT. Add the document element node CALL "CREATE_ELEMENT_NODE OF WEBAPPSUPPORT" USING DOC-TAG, NULLSTRING, NODE-NAME, NEW-NODE GIVING WEB-RESULT. CALL "APPEND_CHILD OF WEBAPPSUPPORT" USING DOC-TAG, DOC-NODE, NEW-NODE GIVING WEB-RESULT. Get XML document, written to an MCP stream file MOVE "OUTPUT/""PRODUCT.XML""" TO FILE-NAME. CALL "GET_XML_DOCUMENT OF WEBAPPSUPPORT" USING DOC-TAG, DESTINATION-FILE, OUTFORMAT-NOWS, FILE-NAME, START-AT-ZERO, XML-LENGTH GIVING WEB-RESULT Unisys Corporation. All rights reserved. 23

24 Language Integration Opportunities Native Interface 2012 Unisys Corporation. All rights reserved. 24

25 Native Interface (JNI) standard API for calling C++ DLLs Extended to call C and ALGOL on MCP Application Library JNI Library Application Connection Worker Worker Proxy C++ DLL Class JVM JProcessor RUN *DIR/JREn/BIN/JAVA ( -cp MyClass ); 2012 Unisys Corporation. All rights reserved. 25

26 JNI Development Process Create a class with native methods On MCP or desktop, run com.unisys.mcp.tools.hp to generate: C++ library source for JProcessor Compile with a Microsoft C++ compiler, e.g., Visual C++ Express 2010 Copy DLL to *DIR/<JREn>/JDK/DLL32 on MCP Install the DLL to EACH JProcessor with InstallJNI utility * ALGOL or C source file that becomes your library Modify the ALGOL or C source file as needed Copy library to *DIR/<JREn>/BIN or SL Application Library JNI Library Application Connection Worker Worker Proxy C++ DLL Class JVM JProcessor 2012 Unisys Corporation. All rights reserved. 26

27 JNI Example Calling MCPSUPPORT or CENTRALSUPPORT functions MCPSUPPORT CENTRALSUPPORT JAVATIMELIB Worker Proxy C++ DLL Time Class JVM JProcessor RUN *DIR/JRE7/BIN/JAVA ( com.unisys.mcp.time ) In ALGOL: time6 := TIME(6); In : Time time6 = new Time(6); 2012 Unisys Corporation. All rights reserved. 27

28 JNI Example private static native long Time48(int private static native double TimeDouble(int encoding=encoding.ebcdic) private static native String TimeString(int exp); 2012 Unisys Corporation. All rights reserved. 28

29 JNI Example - direction=direction.out, com_unisys_mcp_convention_cs_dataokv", encoding=encoding.ebcdic) private static native String SystemDateTime(int String String convention) throws com.unisys.mcp.conventionexception; 2012 Unisys Corporation. All rights reserved. 29

30 JNI Example ALGOL Source File % % Class: com_unisys_mcp_time % Method: Time48 % Signature: (I)J % ID: 18 % Comment: % Parameters: % REAL PROCEDURE JAVA_COM_UNISYS_MCP_TIME_TIME48 (ENV, this_class, EXP_X); VALUE this_class, EXP_X ; REAL ARRAY ENV[*]; DOUBLE this_class; % Input INTEGER EXP_X; BEGIN JAVA_COM_UNISYS_MCP_TIME_TIME48 := TIME(EXP_X); END; 2012 Unisys Corporation. All rights reserved. 30

31 JNI Example ALGOL Source File PROCEDURE JAVA_COM_UNISYS_MCP_CONVENTION_SYSTEM_DATE_TIME (ENV, this_class, TYPE, LANGUAGE, LANGUAGE_SIZE_, CONVENTION, CONVENTION_SIZE_, RC, RESULT_, RESULT_SIZE_); VALUE this_class, TYPE, LANGUAGE_SIZE_, CONVENTION_SIZE_ ; REAL ARRAY ENV[*]; DOUBLE this_class; % Input INTEGER TYPE; EBCDIC ARRAY LANGUAGE[*]; % Input INTEGER LANGUAGE_SIZE_; EBCDIC ARRAY CONVENTION[*]; % Input INTEGER CONVENTION_SIZE_; INTEGER RC; EBCDIC ARRAY RESULT_[*]; INTEGER RESULT_SIZE_; BEGIN EBCDIC ARRAY FD_ARY[0:96]; INTEGER DATE_LEN; RC := CNV_SYSTEMDATETIME_STAR(TYPE, CONVENTION, CONVENTION_SIZE_, LANGUAGE, LANGUAGE_SIZE_, DATE_LEN, RESULT_SIZE_, FD_ARY, SIZE(FD_ARY) ); IF RC EQL CS_DATAOKV THEN BEGIN JNI_RESIZE_EBCDIC_ARRAY_PARAM(RESULT_, RESULT_SIZE_); REPLACE RESULT_[0] BY FD_ARY FOR RESULT_SIZE_; END ELSE BEGIN RESULT_SIZE_ := 0; END; END; 2012 Unisys Corporation. All rights reserved. 31

32 JNI Guidelines Read Native Interface for MCP in *JREDOC Start with samples found in *JREDOC Data mapping differences 32-bit integers 16-bit characters Not all JNI methods are fully implemented due to MCPJAVA architecture (12 out of ~250) 2012 Unisys Corporation. All rights reserved. 32

33 COBOL/ALGOL to API developed to call methods Based on C JNI method definition Calls for identifying methods by name Calls for identifying objects by name Chatty and error prone Simplified with com.unisys.mcp.tools.jifgen Reads source and generates entrypoint INCLUDE file Does all the dirty, error-prone work Application JNI Interfaces JNI Proxy Lib Worker Worker Class JVM JProcessor 2012 Unisys Corporation. All rights reserved. 33

34 INJ Development Process Create or identify a class with public methods On MCP or desktop, run com.unisys.mcp.tools.jifgen to generate: A language appropriate include file For COBOL, an ALGOL library with COBOLized entrypoints Also include the appropriate file from *DIR/JREn/JDK/INCLUDE Add code to create and destroy the JVM Add code to call the include file procedures Application JNI Interfaces JNI Proxy Lib Worker Worker Class JVM JProcessor 2012 Unisys Corporation. All rights reserved. 34

35 INJ Example method public void startentry( String filename ); ALGOL representation PROCEDURE ZIPTEST_ZIP_TEST_START_ENTRY (JNIEnv, this_object, FILENAME, FILENAME_OFFSET, FILENAME_SIZE); VALUE this_object, FILENAME_OFFSET, FILENAME_SIZE; REAL ARRAY JNIEnv[*]; DOUBLE this_object; % Input EBCDIC ARRAY FILENAME[0]; % Input INTEGER FILENAME_OFFSET; INTEGER FILENAME_SIZE; % Input COBOL-85 representation 01 P1-FILENAME PIC X WITH LOWER-BOUNDS. 77 P1-FILENAME-SIZE PIC 9(11) BINARY CONTENT. ENTRY PROCEDURE START-ENTRY FOR "ZIPTEST_1" WITH ZIPTEST-PARAMS USING JNI-ENV, THIS-OBJECT, P1-FILENAME, P1-FILENAME-SIZE Unisys Corporation. All rights reserved. 35

36 Discuss Amongst Yourselves Or with me!

37 COBOL Application to Multiple Databases Problem Access a DMSII database and an Oracle database Connections constructed and broken down for each request Possible solution JBoss or Tomcat with JNDI Connection Pool on JProcessor Call class passing database keys Obtains database connections from connection pool Returns when finished DMSII Database Connection Pool Oracle Database Application JNI Interfaces MCP Environment JNI Proxy Lib Worker Worker Class Connection Pool JVM JProcessor 2012 Unisys Corporation. All rights reserved. 37

38 Web Access to EAE Reports Problem Web access to EAE application Multiple simultaneous requests Possible solution Tomcat on JProcessor JSP/Servlet accepts incoming requests Tomcat connection pool with tailored connector Connector JNI methods to call ALGOL dispatcher ALGOL dispatcher initiates EAE reports and returns results EAE EAE Report EAE Report EAE Report Report JNI JNI Dispatcher Library Worker Tomcat Proxy C++ DLL JSP Worker Tomcat JProcessor 2012 Unisys Corporation. All rights reserved. 38

39 Questions? Comments? Confused? 2012 Unisys Corporation. All rights reserved. 39