EPC - 805

Date : 26 March 2007

EPC805 Highlights

EPC805 delivers enhancements and corrections to LANSA Integrator. The following are some of the most notable items:

A variety of useability and functional improvements to the user-interface, including a new repository viewer for viewing the contents of the LANSA Repository.
Various performance improvements including a new JSM pool server for distributing JSM workload across multiple JSM instances on the same machine or across multiple machines.
A variety of useability and functional enhancements to XML and SOAP wizards and services.
Enhancements to the PDF document service.
A new JSON Wizard and an accompanying HTTPInboundJSONService for sending JSON (Javascript object notation) messages. JSON is or can be used as an alternative to XML and other formats in some applications.
Other new services including:

OpenLDAPService
XMLBindQueueService
HTTPInboundXMLBindService
HTTPInboundQueryService
SMTPMailAttachmentSignatureService

Refer to Detailed changes for more information about the changes delivered in this EPC.

Product	LANSA Integrator
Version	11 SP4
Pre-Requisite Details	Java 1.4 LANSA Integrator installed from CU1 CD (EPC752) or later (iSeries) LANSA Integrator installed from CU3 CD (EPC772) or later (Windows) Windows: supported versions of Windows as documented on our web-site. In particular refer to the web-site for the latest information concerning support for Microsoft Windows Vista. iSeries: i5/OS or OS/400 at a release level supported by IBM - at time of writing, the earliest supported release was V5R2M0.
Related Products	LANSA for iSeries and/or Visual LANSA
Full Distribution In	V12.0
Special Notes	If you are running custom services (services not provided with the LANSA Integrator product shipment), then you should re-test such services after applying the EPC. If your custom services do not work after applying the EPC, then you may need to re-compile the .class object for the services.
Document Updates	An updated version of the LANSA Integrator Guide is included.

Description

EPC805 contains updates to iSeries and Windows components of LANSA Integrator.

Instructions to install the EPC

EPC805 includes software to be installed on an iSeries machine or Windows machine. These instructions describe the installation and use of all delivered items.

Download EPC805.EXE file from Web site or email.
Unzip (double click) EPC805.EXE. These files will be extracted:
- this document, EPC805.htm
- EPC805 - iSeries Save file
- EPC805w.exe - Windows install executable
- RFI_EPC805.exe - RFI install executable
- UA_EPC805.exe - Independent User Agent install executable
- LANSA093.chm - updated version of the LANSA Integrator Guide

Instructions provided for:

Yes	LANSA Integrator on iSeries
Yes	LANSA Integrator on Windows
No	LANSA Integrator on Unix or Linux
Yes	Additional Install notes

Detailed changes

EPC805 includes these changes [Click here to Show table...]

CCS id.	Description
0126170	Add disable output escaping to XMLBind Wizard The XMLBind Wizard now provides an option not to escape xml tags present in mapped field content. This permits program logic to be used in conjunction with the mapping provided by the LANSA Integrator service to accomplish more complex mapping tasks.
0126171	Add return value support to SQLService CALL stored procedures The EXECUTE CALL(...) CALLTYPE(*EXECUTE) command of the SQLService has been enhanced with the ability to return a value.
0126193	Improve XML editor formatting of XML The Format command of the LANSA Integrator Studio XML Editor formats the XML in the editor so that it has consistent use of line breaks, spaces and indentation. This makes reading and editing the XML easier. The formatting is performed by means of an XSL transformation. Previously this could lead to loss of namespace declarations for unused namespaces. This version takes advantage of an XSLT 2.0 feature to prevent the loss of namespaces.
0126234	Improve exception error tracing Set null status and message values to null, and trim and uppercase status Change print method ( command, throwable ) so it traces the same status and message as that returned in the JSMResponse object Use cause exception from InvocationTargetException exceptions
0126286	Create LDAP service using OpenLDAP The OpenLDAPService allows you to develop applications that can access LDAP compliant directories. LDAP (Lightweight Directory Access Protocol) is a protocol that is becoming more and more prevalent in databases and systems throughout the world. It is a protocol that is widely accepted as the industry standard for deploying directory based applications and solutions.
0126288	Trace the fact that the service resource is empty Also trace the fact that a response message could not be obtained and return the message identifier as the reponse message. The additional tracing permits easier diagnosis of common problems.
0126307	JSM requires working list max entry count The maximum size of a working list is now passed on to the JSM Server. This permits more efficient use of Integrator services with LANSA RDMLX applications.
0126319	Add isEmpty and getBundle methods to JSMResource interface The new methods offer better support for developers of custom JAVA services for use with LANSA Integrator.
0126332	Fields used as visual components are not exchanged to JSM service Fields used as visual components are now exchanged to JSM service when using SERVICE_EXCHANGE(*FIELD)
0126416	Integrator Studio - RPG structure Editor - Allowed to create duplicate element The structure editor now prevents the creation of duplicate structure elements.
0126417	Create XMLBindQueueService to using xml binding for XML messages The XMLBindQueueService allows an XML binding defined with the XML Binding Wizard in LANSA Integrator Studio to be used when sending and receiving XML messages via MQSeries message queues and iSeries data queues.
0126418	Create HTTPInboundXMLBindService to use binding for inbound and outbound XML The HTTPInboundXMLBindService allows an XML binding defined with the XML Binding Wizard in LANSA Integrator Studio to be used when receiving XML messages via inbound HTTP.
0126427	Remove copy-namespace from xsl:copy-of element. The XMLEditor format uses the XSL xsl:copy-of element. Remove the copy-namespaces from xsl:copyof element. Add Yes/No option dialog to the format, so the user can cancel the request.
0126454	DCXS882X - V5R4 gethostbyname API is not behaving the same as previous releases The gethostbyname is sometimes returning a hostentry for dotted-decimal names. Change logic so inet_addr API call is done first and if this fails then do gethostbyname API call.
0126457	XMLQueueService, return ERROR status if archive content is null The XMLQueueService needs to return an ERROR status if the content to be archived is null. ie. there is no content to archive. Currently a zero length archive file is created.
0126511	XMLParserService STORE command should return ERROR status for null source XMLParserService STORE command can store the load source or the transformed source. If these are both null, the STORE command will now return an error status. In addition the STORE command has been modified to make sure the encoding specified in the output xml declaration suits the actual encoding used.
0126514	XML Wizards - allow expand and collapse to work on selected node
0126573	Add support for compression and attachments to PDFDocumentService Support for PDF document compression and attachments has been added to the PDFDocumentService. The support is implemented through new markup in the xml content file that is used with this service.
0126667	Update JavaMail to version 1.4 and JAF to version 1.1 This updates the version of these open source java components that are shipped with LANSA Integrator.
0126698	Support using Bouncy Castle for S/MIME Enhance SMTPMailService to use Bouncy Castle. Autodetect BC provider and add as security provider when JSM starts.
0126699	Add sort-type-elements attribute to SOAP Server Types Control whether elements are sorted or remain in creation order
0126709	Enhance POP3MailService to handle compressed and multipart/signed messages
0126796	DCXS882X - set socket send and receive buffer to 128K and enable no delay. These changes are designed to optimize TCP/IP socket performance with affected LANSA Integrator services.
0126801	Add manager properties tcp.buffer.send, tcp.buffer.receive and tcp.nodelay These properties are used to set TCP/IP socket options for the JSM listener. Where necessary, these properties may be used to fine-tune TCP/IP socket performance.
0126804	TRACE_NAME(PROCESS) for VLF components use COMPONENT, * is an illegal OS value This change removes the * character from trace file names automatically generated by LANSA Integrator when the TRACE_NAME(*PROCESS) option is specified on the SERVICE_LOAD command. This is to ensure the generated name is a valid name in the file system.
0126826	Change iSeries JSMPROXY code to use inet_addr API call first The gethostbyname is sometimes returning a hostentry for dotted-decimal names. Change logic so inet_addr API call is done first and if this fails then do gethostbyname API call. Also set send and receive socket buffers to 128K and disable Nagle algorithm
0126845	Set Studio IDEConnection to use send and receive buffers of 128K The new socket send and receive buffer sizes are set for optimal performance.
0126868	Tidy up Apache Axis generated WSDL file Tidy up the WSDL file that is generated for a SOAP Wizard generated SOAPServer solution.
0126884	Set send and receive buffer sizes to 65536 for FTPService New send and receive buffer sizes are for optimal performance and throughput for FTP operations.
0126914	Enable TERASPACE support for DCXS882X RDML BIFs Also only send HTTP content once, the first SERVICE_LOAD command gets the HTTP content and any other SERVICE_LOAD command have no content.
0126916	Add encoding CP037 to XML editor encoding menu
0126917	Add support for ActiveMQ to JMSFileService Apache ActiveMQ is a popular open source Message Broker.
0126918	Map CCSID 1388 to Java encoding Cp1388 Now that iSeries JDK 1.4 and 1.5 support Java encoding Cp1388 and Cp1371, change CCSID 1388 and 1371 mapping to Cp1388 and Cp1371 respectively. Previously they were mapped to Cp935 and CP937.
0126985	Clear temporary directory on JSM CLOSE Previously the JSM service programmer was required to clear the temporary directory. Now the JSMManager will clear the temporary directory on a JSM CLOSE. This will allow temporary files created in one service to be used by the next loaded service and each service does not need to manage that the temporary file needs to be deleted.
0127043	Add socket read timeout to RFI Add rfi.timeout property to RFI service to allow the socket read timeout to be set.
0127044	Increase digit length support for Packed and Zoned from 31 to 63 This change provides compatibility for recent 3GL System i applications and for LANSA RDMLX applications.
0127074	Enhance SMSService to receive multiline SMTP response lines This enhances compatibility with SMS gateways using the SMTP protocol.
0127086	RDML BIF - Allow SERVICE_EXHANGE(FIELD) to be case insensitive Allow mixed case entry of the SERVICE_EXCHANGE(FIELD) command keyword string. Previously this keyword and value was recognised only if entered in uppercase as shown. NB: Presently this change applies only on System i (iSeries). Equivalent support on Windows platforms will follow in a later EPC.
0127107	Add gzip compress to HTTP responses Add support for gzip compression for HTTP responses. The UAGZIP keyword determines if content compression is required.
0127112	Add support for content encoding CGI variable Add support for CGI variable Content-Encoding - HTTP_CONTENT_ENCODING and HTTP_ACCEPT_ENCODING to JSMProxy and DCXS882X service program.
0127115	Add content.encoding property to UserAgent properties Allow UserAgent to post compressed data and to uncompress response if protocol contains Content-Encoding: gzip property
0127125	RFI - make sure that the socket connection is closed after each request Removed a close method on the RFIService class which should not be there
0127126	DV ERROR : "SOAPServiceHelper: cannot find get or is method for fragment entity: Change SOAP service code to use methods from the base class.
0127170	Ship JSM with an active LOG4J log4j.properties Several open source products used by LANSA Integrator use the Apache LOG4J logging services. Supplying an active LOG4J properties file makes it easier to enable this type of logging when necessary.
0127282	JSMDIRECT checks for LANSA when only running RPG program via JSMLSAEXT Only check for LANSA if JSMLSAEXT program does not exist.
0127294	Add a backgound design grid to each page for PDFDocument service Add a grid attribute to the document element to turn on a design grid for each page. This change applies to the xml content file that is used with the PDFDocument service.
0127326	Add the ability to set the manager and service thread priority Add two new manager properties to control the thread priority of the manager thread and the service thread.
0127342	Add support for date formulas in ExcelReadService and UserAgent Allow date formula to be converted into date strings.
0127392	Allow all HTTP protocol properties to be passed onto JSM service Enhance DCXS882X service program to collect all HTTP properties and to pass these name/values into the JSM service. Previously only selected HTTP protocol properties were available to the JSM service.
0127404	Allow JSMProxy to pass all HTTP protocol properties The HTTP protocol properties are now available to the JSM service. Previously only selected HTTP protocol properties were available to the JSM service.
0127409	Add more tracing of MapFormat class to XMLBind processing Additional tracing is provided to facilitate problem diagnosis for applications using XMLBind services.
0127429	Add ignore namespace prefix capability to XMLParserService Add IGNORE-PREFIX keyword to the LOAD command. This will remove the namespace prefix from the node name used in the name compare logic.
0127443	Preprocess prepared INSERT statements with keyword VALUES(CALC) For INSERT statements used with the SQLService, replace keyword VALUES(CALC) with binding parameter markers in the form VALUES ( ?,?,... )
0127469	RDMLX BIF sending negative numbers with trailing sign Detect that a trailing negative sign and convert to normal format. Add trailing negative sign when returning value to RDMLX function.
0127508	Complete the task of applying numberformat to RDMLX numbers Apply the NUMBERFORMAT keyword value to RDMLX numbers
0127559	Improve AS2 tracing Move HTTP protocol and content tracing into HTTP request layer, so the wire protocol is traced. Add more tracing to AS2 services
0127736	Incorrect status returned if SVColumn does not exist in SVFileService An error status will occur if sv.column. resource does not exist.
0127770	Enhance SQLService to automate the VALUES bind parameters Add support to the SQL statement parser to convert VALUES(CALC) into the number of necessary bind parameters ? and VALUES(ALL) to generate bind parameter ? and default values for all columns in the table
0127771	Improve support for Oracle JDBC driver and database Add the keyword CALLSYNTAX to the CALL command so JDBC or ORACLE call syntax can be used. Add more RETRUN parameter data types and include a special keyword value of an oracle cursor (*ORACLECURSOR).
0127772	Update 3rd Party jar files Upgrade Bouncy Castle jar files to version 1.3.4 Update JXL jar file to version 2.6.1 This updates the version of these open source java components that are shipped with LANSA Integrator.
0127773	Enhance XMLBindWizard and XMLBind services to handle xml: namespace Allow the XMLBindWizard to map to attributes in the xml namespace. The xml namespace is a prefined and reserved namspace used by attributes like xml:lang
0127788	Make Text/XML editors refresh studio when new file created Also, assign text icon to files with .edi and .x12 extensions and allow these files to be opened using Studio text editor.
0127891	Create JSON Wizard and HTTPInboundJSONService The new service supports sending and receiving JavaScript object notation messages.
0127964	Create HTTPInboundQueryService Develop a service that allows an SQL command posted by a browser client to return a result set.
0128022	Add SSL tuneling support to HTTP outbound services Allow HTTP services to use SSL via a proxy server
0128039	Change SMIME name="smime.p7m" to name="smim.p7z", as per RFC 3851 This is as per RFC 3851 for AS2 outbound HTTP content type.
0128040	Update 3rd party jar files Update JXL jar file to version 2.6.2 Update PDF jar file to version 1.4.8 This updates the version of these open source java components that are shipped with LANSA Integrator.
0128050	Add maintain session and shared locator capability to SOAP Agent Allow the SOAP agent service to reuse the locator object across operation calls, so cookie sessions can be maintained
0128051	Add SSL tunneling support to AS2 HTTP transport Add basic proxy authentication and SSL tunneling to AS2 HTTP transport and AS2OutboundService and AS2OutboundReceiptService
0128078	Remove Connection: close from HTTP response It has been observed that when using HTTPS with IIS/5.0, that Connection:close is duplicated. Do not send Connection:close in the HTTP response. It has also been observed that Apache already includes a Connection: close, but does not duplicate the property. HTTP with IIS/5.0 also does not duplicate this property.
0128118	Make sure that SMIME private key and certicate file input streams are closed Tidy up getPrivateKey and X509 certifcate logic not to use FileInputStream and if they do then close the FileInputStream. Changes to JSFPKIEditor, AS2 services and SMTP SMIME services.
0128119	LANSA Integrator has been tested with Java version 1.5 of supported JVMs LANSA Integrator operates successfully with Java version 1.5 of supported JVMs.
0128177	Allow Studio to open files using Window's associated application LANSA Integrator Studio can now open files using Window's associated application. For example, XLS files open in Microsoft Excel, if Excel is associated with files of that extension.
0128252	Add support for mulitpart/signed format to SMTPMailService Add the MULITPARTSIGNED(*YES) keyword to the SEND command so the signed message is constructed in the mulitpart/signed format.
0128294	Add more viewer preferences to PDFDocumentService Viewer preferences can control the preferred mode of presentation when the document is opened in the Acrobat Reader.
0128306	Add READ command to PDFDocumentService Allow PDF document information to be read. This allows Author, Title, Subject, Keywords, Creation Date and other properties to be read.
0128332	Allow PDFDocumentService to read mulitpage TIFF images Add the page attribute to the image element to allow a specified page from a TIFF file to be read or all pages to be included.
0128381	Cannot import private key into JKS keystores using JDK 1.5 The keystore class in JDK 1.5 requires a PrivateKey object and not a Key object. Pass key as a PrivateKey and not Key.
0128435	Replace passwords in trace files with *** Passwords in trace files are now obscured by default with *** in the LANSA Integrator trace output.
0128437	Add support BKS and JCEKS keystore support to PKIEditor This allows PKIEditor to operate with Bouncy Castle keystore and Java JCE keystore.
0128438	Create SMTPMailAttacmentSignatureService This allows a single file attachment and digital signature to be emailed.
0128530	Update Look & Feel with latest JGoodies look 2.1.1 This refers to the open source software used for UI presentation in LANSA Integrator.
0128538	Allow SVFileService to append content to local files Add the APPEND keyword to the WRITE command.
0128545	Upgrade ActiveMQ to version 4.1.0 Use the ActiveMQ version 4.1.0 when compiling JSM services and UserAgent
0128555	Add GZIP and HTTP/1.0 support to SOAPAgentWizard Enhance the SOAP Agent Wizard code generator to add additional code to support GZIP and HTTP/1.0 protocols
0128560	Allow Studio to call Window's Services Manager and Certificates Manager This provides direct access to the Windows services and certificates management consoles from the View menu within LANSA Integrator Studio.
0128576	Enhance LI upgrade process Add a new instruction ADD_xxx, this will only add the file if the target file does not exist. # DELETE_JAR xxx.jar # DELETE_ENDORSED xxx.jar # # ADD_SYSTEM_FILE xxx # ADD_INSTANCE_FILE xxx # ADD_PROPERTIES_FILE xxx # # DELETE_SYSTEM_FILE xxx # DELETE_INSTANCE_FILE xxx # DELETE_PROPERTIES_FILE xxx # # REPLACE_SYSTEM_FILE xxx # REPLACE_INSTANCE_FILE xxx # REPLACE_PROPERTIES_FILE xxx # # UPDATE_SYSTEM_PROPERTY xxx.properties # UPDATE_SERVICE_PROPERTY xxx.properties
0128577	Ship Apache Axis client and server configuration files During an LI upgrade if system/axis-client-config.xml and system/axis-server-config.xml do not exist then new files are installed. ADD_SYSTEM_FILE axis-client-config.xml ADD_SYSTEM_FILE axis-server-config.xml Also the AxisDefault.properties file will be shipped with these files configured axis.ClientConfigFile=system/axis-client-config.xml axis.ServerConfigFile=system/axis-server-config.xml
0128654	Refactor socket code to use JDK 1.4 API's Rework all code using sockets to use JDK 1.4 API's. HTTP outbound services, AS2 services, FTP services and UserAgent have been modified.
0128655	Change XMLBind service tracing logic to reduce String object creation XMLBind services and JSONBind services now use an integer based system to control trace indenting logic. This will improve peformance for those services when tracing is enabled.
0128668	Add deployment support to Studio This enhancement adds support for deploying LANSA Integrator Studio solutions to another LANSA Integrator installation - for example, from development to production environments.
0128674	Blank RUNJSM java.endorsed.dirs property when in pending or upgrade mode This will allow upgrade instructions DELETE_FILE and DELETE_ENDORSED to be able to delete files in the endorsed directory.
0128675	Add new upgrade instructions DELETE_FILE and DELETE_DIRECTORY This will allow specified files and directories to be deleted.
0128683	Add GET OBJECT(PARAMETERLISTROW) command to SQLService When an exception occurs during processing of a prepared SQL statement that is using a parameter list, retain the error row and allow the function to get the value by using the GET OBJECT(PARAMETERLISTROW) command
0128806	Allow JMS message properties to be sent by JMSFileService Include additional JMS properties when sending and receiving JMS messages. CorrelationId, Priority and other standard properties.
0128807	Add support for WSDL <any> MessageElement type to SOAPAgentWizard This allows the application to process the content of an <any> MessageElement.
0128823	Enhance PKIEditor to be able to edit a PKCS12 keystore
0128840	Change PKIEditor default file extensions Move away from the generic .der extension. Use .cer for X509 certificates, .p8 for private key. .p10 for certificate request.
0128916	Refactor PKIEditor to be less dependent on Phaos Move Phaos create certificate logic into standard code so PKIEditor does not require Phaos to do other tasks, such as reading keystores.
0129037	Allow just SV header columns to be read into a list Add SVMODE(*COLUMN) to allow header columns to be added to a single field working list. Each column is added as an entry to the list.
0129208	Add Pool server to JSM The JSM pool server permits JSM_OPEN request to be distributed to more than one JSM instance on a round-robin basis, allowing JSM workload to be better distributed on a single machine or across multiple machines.
0129210	New columns in DC@W29 support requests through JSMDIRECT for WSDL Using this new support, Web service clients can now request the WSDL for a published web service through the JSMDIRECT interface. NB: Presently this change applies only on System i (iSeries). Equivalent support on Windows platforms will follow in a later EPC.
0129228	Add Studio icon support for .xhtml file extension
0129229	Remove CLRJSM from STRJSM and RUNJSM programs Do not clear temporary files when STRJSM and RUNJSM programs start
0129246	Enhance XMLQueueService to allow user-specified XML Declaration Encoding value Additional properties dq.put.encoding.declaration and mq.put.encoding.declaration to control the XML declaration during the XML declaration modification process.
0129313	Change Studio New Solution dialog combo entry labels The text descriptions for the tools in the "Tool" drop-down have been revised to make them clearer.
0129333	Add icon support for .css and .atom file extensions
0129335	Allow FileChooser dialog to use System Icons when showing files Allow FileChooser dialog to use System Icons when showing files. File will be shown with associated icons.
0129336	jGoodies Look and Feel upgrade to version 2.1.2
0129385	Add more icons to Studio
0129394	Have XMLBindWizard generate 3 sample .properties files Generate XMLBindFileService.properties, XMLBindQueueService.properties and HTTPInboundXMLBindService.properties
0129403	Change dialog Ok to OK This defect has now been rectified
0129410	Set some transform result text area's to use monospaced 12 font This defect has now been rectified
0129425	Determine service count by counting the number of service threads The service count can be obtained by using Studio and Console.
0129443	Replace Vector class with ArrayList class Vector has synchronized methods. ArrayList has no synchtonized methods.
0129444	Replace SOAP services tracing indenting with an integer based logic This will improve performance by reducing the number of String objects being created.
0129452	Allow support for validating and non-validating XML parser in XML services Allow the SERVICE_LOAD VALIDATING keyword to control whether the XML service will use a validating or non-validating XML parser.
0129456	Add disable load DTD grammar parser feature to Studio wizards Refactor XMLBindWizard, XSLWizard, UserAgent, Studio transform and XML viewer, Test Wizard and XML editor to use the disable load DTD grammar parser feature. This allows the EntityResolver logic to be removed as most tools require no XML validation to be done. The XML Editor Validation option will use a validating XML parser so DTD and XMLSchema grammar can be used for validating the XML document.
0129482	Have XMLEditor format keep comments, processing instructions and CDATA sections
0129588	Add .cer and .pem extensions on file save and refresh studio on file creation This defect has now been rectified
0129607	Create Repository Viewer The Repository Viewer permits the contents of the LANSA repository to be viewed from within LANSA Integrator Studio.
0129609	Remove unneceesary Studio refresh to improve the user experience This defect has now been rectified
0129661	Each new imported page should use the document default background color A background attribute has also been added to the import element to allow a particular color to be used. This refers to the xml content used by the PDFDocumentService.
0129662	The ZipService is using directory entries in a zip file WinZip creates directory entries Add logic to ZipService to ignore directory entries
0129672	MS SQLServer JDBC driver does not handle embedded blanks in the CALL statement Change CALLSYTNAX *JDBC so not blanks occur after the leading { and before the trailing } brackets
0129701	Recognize that a file with extension PFX is a PKCS12 keystore file
0129705	Change PDFDocument pagelayout and pagemode attributes Remove single pagelayout-xxx and pagemode-xxx boolean attributes with replace with page-layout and page-mode attributes that take a string value

Affected objects

iSeries and Windows Components: [Click here to Show table...]

Object Name	Folder	Platform
jsm.jar	LANSA Integrator Instance jar directory	All
jsmas2.jar	LANSA Integrator Instance jar directory	All
jsmaxis.jar	LANSA Integrator Instance jar directory - Axis 1.4	All
axis.jar	Component
commons-discovery-0.2.jar	Component
commons-logging-1.0.4.jar	Component
jaxrpc.jar	Component
saaj.jar	Component
wsdl4j-1.5.1.jar	Component
log4j-1.2.8.jar	Component
jsmedimap.jar	LANSA Integrator Instance jar directory	All
jsmide.jar	LANSA Integrator Instance jar directory	All
jsmjaf.jar	LANSA Integrator Instance jar directory - JAF 1.0.2 update	All
jsmmail.jar	LANSA Integrator Instance jar directory - JavaMail 1.3.2	All
mail.jar	Component
jsmnative.jar	LANSA Integrator Instance jar directory	All
jsmpdf.jar	LANSA Integrator Instance jar directory - iText 1.4	All
jsmpdfcjk.jar	LANSA Integrator Instance jar directory	All
jsmrfi.jar	LANSA Integrator Instance jar directory	All
jsmscript.jar	LANSA Integrator Instance jar directory - Rhino 1.6.2	All
jsmservice.jar	LANSA Integrator Instance jar directory	All
jsmsoap.jar	LANSA Integrator Instance jar directory	All
jsmutil.jar	LANSA Integrator Instance jar directory	All
jsmxalan.jar	LANSA Integrator Instance jar directory - Xalan 2.7.0	All
xalan.jar	Component
xercesImpl.jar	Component
xml-apis.jar	Component
jsmxls.jar	LANSA Integrator Instance jar directory - JExcel 2.6.0	All

iSeries only Components: [Click here to Show table...]

Object Name	Object Type	Library
CHGJSMAUT	*CMD	*JSMLIB
CHGJSMDFT	*CMD	*JSMLIB
CHGJSMOWN	*CMD	*JSMLIB
CLRJSM	*CMD	*JSMLIB
CRTJSMSBS	*CMD	*JSMLIB
EDTJSMMGR	*CMD	*JSMLIB
EDTJSMSRV	*CMD	*JSMLIB
OPTJSM	*CMD	*JSMLIB
RUNJSM	*CMD	*JSMLIB
STRJSM	*CMD	*JSMLIB
WRKJSM	*CMD	*JSMLIB
BI@P277	*PGM	*PGMLIB
BI@P278	*PGM	*PGMLIB
BI@P279	*PGM	*PGMLIB
BI@P280	*PGM	*PGMLIB
BI@P281	*PGM	*PGMLIB
BI@P282	*PGM	*PGMLIB
BI@P303	*PGM	*PGMLIB
CHGJSMAUT	*PGM	*JSMLIB
CHGJSMDFT	*PGM	*JSMLIB
CHGJSMOWN	*PGM	*JSMLIB
CLRJSM	*PGM	*JSMLIB
CRTJSMSBS	*PGM	*JSMLIB
DC@P8700	*PGM	*JSMLIB
EDTJSMMGR	*PGM	*JSMLIB
EDTJSMSRV	*PGM	*JSMLIB
JSMADMIN	*PGM	*JSMLIB
JSMAUTH	*PGM	*JSMLIB
JSMBUILD	*PGM	*JSMLIB
JSMCHECK	*PGM	*JSMLIB
JSMCHGJOB	*PGM	*JSMLIB
JSMCHGUSER	*PGM	*JSMLIB
JSMCLEAR	*PGM	*JSMLIB
JSMDIRECT	*PGM	*JSMLIB
JSMDQGET	*PGM	*JSMLIB
JSMDQPUT	*PGM	*JSMLIB
JSMLINK	*PGM	*JSMLIB
JSMMQDEPTH	*PGM	*JSMLIB
JSMMQGET	*PGM	*JSMLIB
JSMMQPUT	*PGM	*JSMLIB
JSMOWNER	*PGM	*JSMLIB
JSMPENDING	*PGM	*JSMLIB
JSMPROXY	*PGM	*JSMLIB
OPTJSM	*PGM	*JSMLIB
RUNJSM	*PGM	*JSMLIB
WRKJSM	*PGM	*JSMLIB
DCXS882X	*SRVPGM	*PGMLIB
DCXS883X	*SRVPGM	*PGMLIB
JSMDTAQ	*SRVPGM	*JSMLIB
JSMMGRSRV	*SRVPGM	*JSMLIB
JSMMSGQ	*SRVPGM	*JSMLIB
JSMUSRSPCE	*SRVPGM	*JSMLIB
LIBLSSRV	*SRVPGM	*JSMLIB
JSM	*MSGF	*JSMLIB
JSMMSGF	*MSGF	*JSMLIB
JSM	*DSPF	*JSMLIB
JSMIFS	*SAVF	IFS Instance objects
JSM	*MENU	*JSMLIB
DC@D8700	*FILE	*JSMLIB
DC@F47	*FILE	*PGMLIB
DC@F48	*FILE	*PGMLIB
DC@W29	*FILE	*JSMLIB
DC@W29V1	*FILE	*JSMLIB
DC@W29V2	*FILE	*JSMLIB
DC@W30	*FILE	*JSMLIB
DC@W30V1	*FILE	*JSMLIB
JSM	*FILE	*JSMLIB
QCLSRC	*FILE	*JSMLIB
QCMDSRC	*FILE	*JSMLIB
QDDSSRC	*FILE	*JSMLIB
QRPGLESRC	*FILE	*JSMLIB

*JSMLIB = LANSA Integrator Program Library, *PGMLIB = LANSA Program Library

Windows Only Components: [Click here to Show table...]

Object Name	Folder
LANSA Integrator Studio	Integrator\Studio
LANSA Integrator User Agent	Integrator\UserAgent
LANSA Integrator Remote Function Invocation	Integrator\RFI
LANSA Integrator on Windows	Integrator\JSMInstance
Integrator\JSMCGI
Integrator\JSMAdmin

Instructions for installing on iSeries

End the JSM server to be upgraded before installing EPC805.
The upgrade process will not be able to replace files that have the READONLY attribute set on. Ensure the JSM instance jar directory has no read only files by using the OS/400 command CHGATR e.g. CHGATR OBJ('/jsm/instance') ATR(*READONLY) VALUE(*NO) SUBTREE(*ALL)
Make a backup of the JSM directory from the iSeries. The current JSM directory will also be saved in the backout library.
Note that the LANSA supplied source files QCLSRC, QCMDSRC, QDDSSRC and QRPGLESRC are replaced by this EPC.
Note that if you have added or updated any entries in the studio project <studio-project id="20000000-000000" name="lansa"> section of any of the property files these will be removed during the upgrade. It is suggested that you place your own entries in a separate studio project section prior to upgrade.
EPC805 must be extracted onto a Windows machine then uploaded onto the iSeries server.
For iSeries shared folders:

in Explorer, map to the shared folder drive
create a folder named EPC805
copy unzipped file EPC805 to folder EPC805

If your network file system is not supporting iSeries shared folders, use FTP via TCP/IP and perform the following steps:

logon to the iSeries and create folder EPC805
open a DOS session on the PC
change to the directory where the downloaded and unzipped files are located
sign on to FTP site - FTP XXXXXXXX (where XXXXXXXX is the name of iSeries system or TCP/IP address)
enter your iSeries user id and password
to send as a binary file : enter command bin
change to QDLS file system : enter command cd /QDLS
change to the folder EPC805 : enter command cd EPC805
to send the downloaded file to the iSeries : enter command put EPC805
to exit : enter command quit

Use the XFLRTOSAVF command to convert the folder to a save file format (LANSA program library must be on your library list) - press F4 for command details. Save file EPC805 will be created by this command.
Sign on as a user profile that is QSECOFR, part of the QSECOFR group, or, has *ALLOBJ and *SECADM special authorities.

NOTE: Check the OS/400 system value QFRCCVNRST. If QFRCCVNRST is set to 0, you must use FRCOBJCVN(*YES) on the RSTOBJ command.

Use the OS/400 RSTOBJ (restore object) command to restore all objects from library QTEMP into library QTEMP.

For a save file you will use the following command:

RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(EPC805) RSTLIB(QTEMP)

Display your current library list. If QTEMP is not shown, then add it to your library list using the ADDLIBLE (add library list entry) command.
Install the EPC using the command:

LOADEPC805 JSMLIB(<jsmlib>) PGMLIB(<LANSA_pgmlib>)

Where <jsmlib> is the name of the LANSA Integrator JSM library. This is often JSMLIB but it may be different on your system.
Where <LANSA_pgmlib> is LANSA program library name and is optional.
Press enter to continue processing.
Save and then delete the backout library (iiiJEPC99 where iii = 1st three letters of your LANSA Integrator library and JEPC99 where 99 = is unique number) created by the install. The contents of the library may be used to back out this EPC and return your system to its previous state.
To install the EPC on another LANSA system, sign off and then on again before commencing the next installation.

Additional Install Notes (iSeries)

The STRJSM program should be checked and recompiled. A sample is provided in file QCLSRC.
The exit programs JSMADMEXT, JSMDRTEXT, JSMLSAEXT and JSMPXYEXT should be checked and recompiled. Samples are provided in file QCLSRC.
Please view the Additional Install Notes section in this document for important post-installation/upgrade checks.

Instructions for installing on Windows (including Integrator Desktop Applications)

End the JSM server to be upgraded before installing EPC805.
Make a backup of the Integrator directory from Windows.
Note that if you have added or updated any entries in the studio project <studio-project id="20000000-000000" name="lansa"> section of any of the property files these will be removed during the upgrade. It is suggested that you place your own entries in a separate studio project section prior to upgrade.
Unzip (double click) EPC805w.exe to start the upgrade of LANSA Integrator on Windows.
NOTE: Please view the Additional Install Notes section in this document for important post-installation/upgrade checks.
If upgrading an independent User Agent install, uninstall the existing User Agent first. This can be done in one of 2 ways:
1. Remove it using Add/Remove programs from the control panel.
2. Start the install (see below) and it will automatically prompt you to remove any existing User Agent installations.
Then unzip (double click) UA_EPC805.exe to start the installation of the User Agent.
You might want to do a backup of your current independent User Agent install before you start the upgrade process.
If upgrading an independent RFI install, uninstall the existing RFI first. This can be done in one of 2 ways:
1. Remove it using Add/Remove programs from the control panel.
2. Start the install (see below) and it will automatically prompt you to remove any existing RFI installations.
Then unzip (double click) RFI_EPC805.exe to start the installation of RFI.
You might want to do a backup of your current independent RFI install before you start the upgrade process.

Additional Install Notes (for Windows Server 2003 only)

In Windows Server 2003, a virtual directory must be created for LANSA Integrator (done automatically for other operating systems). Follow these steps to create it:

In the Installing LANSA on Windows guide, locate the section Create a Virtual Directory for the IIS Plug-in in IIS. Although these steps are for the LANSA for the Web Plugin they can also be used for LANSA Integrator.
As you follow the steps in the Wizard you will need to replace the directory name and path with your own appropriate for LANSA Integrator.
For Access Permissions select "Read" in addition to "Run scripts" and "Execute".

In Windows Server 2003, a Web Service Extension should be created for Integrator's virtual directory (ie; 'cgi-bin', 'cgi-bin-jsmdirect', etc.) for the user to run any CGI programs. Follow the steps below to set that up.

Open the Internet Information Services Manager from Administrative Tools.
Click 'Web Service Extensions'.
Click 'Add a new Web service extension' from the Tasks in the Web Service Extensions window.
In the 'New Web Service Extension' window, write an appropriate name for 'Extension name' and click the 'Add' button to select the 'Required files' for the extension. From the correct location for your Integrator configuration, select jsmdirect.exe, jsmproxy.exe, and jsmadmin.exe.
Click 'OK'.

In Windows Server 2003, correct permission rights should be allocated to the Integrator's virtual directory for the group 'Users' so that dc_w29.txt and dc_w30.txt files can be changed from Integrator Studio. Follow the steps below to set that up.

Open the Internet Information Services Manager from Administrative Tools.
Select the appropriate virtual directory that has been created for your Integrator configuration (ie; 'cgi-bin', 'cgi-bin-jsmdirect', etc).
Right click on the virtual directory entry, and click on 'Permissions' from the context menu.
Select the group 'Users' from 'Group or user names'.
Allow permission to 'Modify' and 'Write' for the group 'Users'.
Click 'OK'.

Additional Install Notes (iSeries and windows)

When the JSM instance starts it will process the files in the upgrade directory. If the upgrade is successful the JSM instance will restart else the instance will end. Check the file UPGRADE-LOG.txt in the JSM instance directory for upgrade messages.

An example of the upgrade messages (not complete) :

Upgrade JSM instance : /jsm/instance - Upgrade properties file : manager.properties Properties file upgraded - Upgrade properties file : service.properties Properties file upgraded - - Upgrade properties file : XMLQueueService.properties Properties file upgraded - Upgrade completed Remove upgrade files - Delete file : /devjsm/instance/upgrade/mailcap.txt - Delete file : /devjsm/instance/upgrade/integrator-feature.txt - - Delete upgrade directory - Removal completed
All the properties files will contain an "unassigned" section. This section contains lines that did not belong to a section.
Review the unassigned section for possible configuration entries. Normally this section just contains # comments and the whole section can be deleted. Use Studio to remove all unassigned sections from property files.

#!<studio-project id="00000000-000000" name="unassigned"> # # Move these entries to a new or existing studio-project section. # Delete this unassigned section. # # #!</studio-project>
PKI Editor
The PKI Editor is available for use when using the secure mime feature when sending and receiving e-mails using the SMTP mail, POP3 mail and EDI-INT (AS2) services. This is only available if the secure mime jar files are installed. These jar files are not shipped with LANSA Integrator as these files relate to Public Key encryption which must be purchased separately from Phaos Technology Corporation to support secure mime (SMIME). In particular, the software that needs to be purchased is:
Phaos Security Engine
Phaos CMS
Phaos S/MIME

Please refer to the Phaos Technology Corporation web site for more information.