EPC - 835

Date : 31 October 2008

EPC835 Highlights

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

Various performance and capacity improvements.
Support for IBM Technology for Java 32-bit and 64-bit JDKs.
New SFTPService that allows FTP using SSH2 protocol.
New JMSXMLBindService to allow the XML binding to be used for JMS message queues.
New XMLReaderService and XMLWriterService that use the Streaming API for XML (StAx).
New HTTPOutboundXMLBindService to allow the XML binding to be used to create outbound HTTP content.
Enhancements to ExcelReadService to allow cell formating.
New Studio tools XMLSchema Viewer and CRL Editor.
A variety of useability and functional improvements to the Studio user-interface.

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

Get this EPC	Download EPC835 via the LANSA Support Portal
Product	LANSA Integrator
Version	11.5.1
Pre-Requisite Details	Java 1.4 LANSA Integrator installed from CU1 CD (EPC752) or later (iSeries) and The LANSA system must be V11 SP5 and EPC level 834 LANSA Integrator 11.3 at EPC level 778 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 V5R3M0. The following PTFs must be applied before this EPC is applied: i5/OS Release / Required PTF V5R3M0 = MF41354 V5R3M5 = MF41734 V5R4M0 = MF40520 V5R4M5 = MF42655 Additional required PTFs for restoring Java programs created on V6R1 or later to an earlier release i5/OS Release / Required PTF V5R3M0 = SI27297 V5R4M0 = SI27765
Related Products	LANSA for iSeries or Visual LANSA
Full Distribution In	N/A
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

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

Instructions to install the EPC

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

Download EPC835.EXE file from Web site or email.
Unzip (double click) EPC835.EXE. These files will be extracted:
- this document, EPC835.htm
- EPC835 - iSeries Save file
- EPC835w.exe - Windows install executable
- RFI_EPC835.exe - RFI install executable
- UA_EPC835.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

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

CCS id.	Description
0129729	Improve EDI processing performance Improve EDI processing performance by reducing the number of objects being created and to replace StringBuffer class with custom StringBuffer class that allows resuse.
0129764	Only show Studio Solution icon if node is a directory Only show Studio Solution icon if node is a directory, files are shown using their associated icon.
0129788	Add logger entry to log4.properties for Axis ProjectResourceBundle Add logger entry to log4.properties for Axis ProjectResourceBundle. This will stop the following message appearing in traces log4j:WARN No appenders could be found for logger (org.apache.axis.i18n.ProjectResourceBundle). log4j:WARN Please initialize the log4j system properly.
0129797	Add tree icon renderer to SEF editor and Test Tool to show custom icons Add tree icon renderer to SEF editor and Test Tool to show custom icons, this improves the L&F on the application.
0129854	Add search constaints to follow referrals to OpenLDAPService Add search constaints to follow referrals to OpenLDAPService
0129875 0130775	Allow JMSFileService to send and receive message without requiring a file Allow JMSFileService to send and receive message without requiring a file to be specified. This feature allows only user defined properties to be sent and received.
0129904	Add support to TextEditor for Cp037 and auto detection for BOM Add support to TextEditor for Cp037 and auto detection for BOM. Check for 16BE, 16LE and UTF-8 Byte Order Markers.
0129957	Create new service, SFTPService that allows FTP over SSH2 The new SFTPService allows FTP over SSH2. There are two secure FTP protocols in commandon. FTPS which is FTP using SSL and FTTP over Secure Shell.
0129967	Allow project groups to be created from the workspace popup menu. This allows projects to be organized within a group.
0129986	Allow Studio to use specified javac.exe and java.exe for byte code compiling. Instead of setting the PATH environement varaible with the location of the java compiler ( javac.exe ). javac.exe and java.exe can be specified from the Studio workspace node. The SOAP and XMLBind wizards will use the specified javac.exe and the SOAP server will use the java.exe for the WSDL generation.
0129992	Enhance MapForce compiler to find javac.exe instead using PATH
0130024	Add custom icons to SOAP Type, JSON Type and RPG type / element nodes to improve the L&F of the application
0130034	Allow repository viewer to drag and drop field name on wizards SOAP Wizard. JSON Wizard, XSL Wizard and XMLBindWizard can receive a field name from the Respository Viewer using Drag Drop
0130085	Add icon support for .CRL file extensions to Studio
0130086	Create a new service HTTPOutboundXMLBindService The HTTPOutboundXMLBindService allows XML created by the XMLBinding Wizard mapping to be POSTED to a remote host using the HTTP procol. Also the HTTP XML response from the remote host can be read using an XML binding map. This service should be used for REST type applications.
0130087	Remove unused Repository menu item from XMLWizard
0130091	Enhance UserAgent excel read to force decimal separator to a standardized "." Cast NumberFormat to DecimalFormat and setDecimalSeparator symbols
0130092 0130591	Enhance ExcelReadService to force decimal separator to a standardized "." Cast NumberFormat to DecimalFormat and setDecimalSeparator symbols
0130112	Add alt-text support to barcodes This allows user specified text to be added to the generated barcode.
0130114	JMSFileService WAITTIME keyword default value should be 0 not -1 Change WAITTIME keyword default value from -1 to 0
0130120	Create CRL editor The CRL editor allows Certificate Revocation List files to be created and updated.
0130163	Refactor dialog field layout so field resize to dialog sizing events to improve the L&F of the application
0130166	Serveral HTTP service SEND trace files should use .XML extension HTTPService OutboundXMLHandler and HTTPOutboundXMLBindService should use the .XML file extension on the SEND trace file
0130167	Read mapped CSV data should throw an error list entry cannot be added When reading mapped CSV data an exception should be thrown if an entry cannot be added to the list.
0130348	Refactor all GUI controls, dialogs and windows to improve the L&F of the Studio and Wizard applications
0130384	Remove json-compile, xsl-compile xml-compile and soap-compile directories. All wizards that generate and compile code, now use the compile directory. The SOAP Agent wizard uses the compile-agent directory.
0130405	Mixed Content type in an email Incident 62579 Add multipart/alternative support
0130518 0133714	Do not lowercase CONTENT keyword for Content-Type A double-quote feature has been added to CONTENT keyword. Values that start and end with double-quotes will maintain case.
0130652	Allow HTTPInboundQueryService to access POSTed CONTENT value Enhance GET command and support for PROPERTY(*CONTENT) keyword value. This allows the program to access the client requested content type of the HTTP content type response.
0130656	Trace exception class and message in PDFSpoolFileService During the CREATE command, if the exception occurs, trace the exception class name and message
0130675	Add multipart/alternative support to SMTPMailService Allow multiple text bodies to be sent
0130676 0130619 0131540	Allow case of HTTP Content-Type and presence of charset to be controlled Add the CHARSET keyword to control the appending of the charset parameter. Use double quoting of CONTENT keyword value to stop lowercasing of value.
0130718	Add RETRY support to AS2 services to support the requirement of the AS2 reliability statement.
0130748	Add comments to shipped AxisDefault.properties file
0130755	Update 3rd party jar file with latest versions jsmaxis.jar - commons-discivery-0.4.jar - wsdl4j-1.6.2 - log4j-1.2.14.jar - commons-logging-1.1.jar jsmxmlsec - xmlsec-1.4.1 jsmwssec - wss4j-1.5.2.jar
0130780	Add support to POP3MailService to get POP3 server UID. Enhance the GET command OBJECT keyword to return the UID of the current message. GET OBJECT(*UID)
0130799	Add support to POP3MailService to allow MIME message header fields to be read GET OBJECT(*HEADER) FIELD( xxxxx)
0130834 0130931 0134405	Allow ExcelReadService to define cell formats and column views. Cells can be formatted using Font number and date formats. Also the width of the column can be defined.
0130835 0130792 0130878	Allow SMTPMailService to send MIME message header properties. This allows user-define MIME header that be used to to control things like notification of delivery.
0130847 0130924	Enhance InboundNameValueHandler to handle BASE64 encoded values. Use the BASE64 keyword to specify which name value is BASE64 encoded.
0130848	iText 2.0.4 has deprecated some methods, change code to use latest methods. Replace methods. width, height, size, scaledWidth, scaledHeight wih getWidth, getHeight, getSize, getScaledWidth, getScaledHeight methods.
0130896	Improve XML editor formatting capability. Preserve DOCTYPE, CDATA section, processing instructions and comments.
0130927	Check upgrade version before applying upgrade Only apply an upgrade with versions match
0130987	Change EPC master JSM IFS directories to use CCSID 37 Previous EPCs directries shipped with CCSID 1252. Change jar files to use 819 XML, XSL and DTA files to use 1208
0130988	Upgrade Xerces from version 2.7.1 to 2.8.1 Ship Xerces and Xalan as separate jar files.
0131041	Add more SSL configuration properties to manager.properties # ssl.SocketFactory.provider=com.ibm.jsse.JSSESocketFactory # ssl.ServerSocketFactory.provider=com.ibm.jsse.JSSEServerSocketFactory
0131043	Add support to PKI editor to add CRL distribution Point extension to client certificate
0131052	Add support for MIME type application/pkix-crl via the keyword CONTENT(*CRL)
0131095 0131081	XMLBindWizard does not generate correct fragment code When the sample XML document contains repeating elements that are spread out over the entire document, the wizard does not correctly generate the fragment heirarchy.
0131151 0135527	Increase JSMDirect STDIN and STDOUT allowed content size to 2G.
0131207	Pass more reserved keyword values to EDI mapping JavaScript functions
0131208	Add an option to allow all SSL server connections to be trusted. If the default SSL factory is not being used and a trust manager needs to be created, the manager property http.ssl.trustServer=true will create a trust manager that trusts all certifcates.
0131244	Add COMMIT and ROLLBACK commands to JMSFileService. This allows JMS message under commitment control to be rollbacked.
0131249	Add input exclusive and input shared mode to MQ BIFs open queue modes
0131254	Allow an existing SOAP Agent project to be used for a new solution. This replaces the manual steps in Appendix E. When a SOAP Agent needs to be updated with a replacement WSDL.
0131316	Add Include Trace Directory feature to Studio Allow Studio to control the depth of trace directory files between returned.
0131317	Refactor XMLBindWizard code generator to create smaller methods, so Java code limits are not reached for large mappings.
0131388	Add an XMLSchema Viewer to Studio to view XMLSchema files in a Tree format.
0131392	Add Expand, Collapse and Qualified popup menu support to XMLViewer
0131419	SOAP services - catch and trace Throwable when loading service class to improve debug.
0131437	Allow SOAP Agent Wizard to recover from a Java source compile error. If the Java code generated from the WSDL2Java stage is incorrect or cannot compile, then the generated source can be manually modified to correct the problem and the compile stage can be completed by double-clicking the agent project file.
0131466	Update system/log4j.properties with file encoding property
0131467	Add support for reading and writing processing instructions to XML Bind services
0131469	NumberFormat is including the group separator, this should not happen for service that use the NUMBERFORMAT keyword.
0131489	Allow studio to view .p8 ( PKCS8 private key ) and .p10 ( PKCS10 Certification Request ) files
0131502	Enhance SOAPAgentWizard to use an external file for Java source files and not to pass source files on the javac command line
0131516	Add NUMBERFORMAT to InboundMultiPartHandler RECEIVE command Allow RECEIVE field values to be parsed using a locale NUMBERFORMAT
0131524	Make NUMBERFORMAT parsing more strict on input characters - Accepts characters 0 to 9 - Accepts leading Locale minus sign and converts to ( - ) - Silently removes leading ( + ) sign - Silenlty ignores Locale grouping separators - Converts Locale decimal separator to standard ( . ) separator - Silently ignores white space, non-breaking space, yen, pound, dollar and Unicode currency symbols.
0131533	Add NUMBERFORMAT support to ExcelReaderService READ and WRITE commands
0131552	Trace both create map and binding times for XML Bind Services to improve the debug process
0131580	New service JMSXMLBindService The JMSXMLBindService allows XML messages to created and read using XML Binding Wizard maps and send and received by the JMS message framework.
0131644	New HTTP service content handlers - InboundXMLBindHandler and OutboundXMLBindHandler. Thes content handler use the maps created by the XML Binding Wizard.
0131646	XMLEditor - Set caret position to 0 after formating text
0131665	Improve expand and collpase logic for SOAPType, JSONType editors 1. When the Editor starts all Types are collapsed. 2. All Types do not automatically expand 3. Expand Types menu item will expand all Types. 4. Collapse Types menu item will collapse all Types. 5. Expand and collapse a single Type by double-clicking on the Type node. 6. Expanded Types stay expanded when elements or types are created, renamed or deleted.
0131754 0131732	Enhance SOAPServerService to allow return parameter element to be set. By default the return name uses the operationname + "Return" and the response element uses operationname + "Response". If the SOAPServerWizard operation return name does not equal the default value, then additional code is generated to add the return name to the SOAPServerProviderProperties object.
0131799	Include submitted job information in STRJSM message JSM1004 Starting Java Service Manager (851639/QOTHPRDOWN/JSMJOB)(DEVJSM/JSM)
0132012	Trace the use of SMTP authentication in SMTPMailService to improve debug
0132047	Add JavaMail session debug support to mail services Allow SMTPMailService, POP3MailService and SMTPMailAttachmentSignature to support session debug by using the service properties session.debug property
0132050	SOAPServerService returns a SOAP Fault 1.1 with a status of 500
0132064	SOAP Fault should return using a HTTP status of 500 instead of 200
0132080	HTTP JSM Exceptions should use a HTTP status code 500 and not 600
0132099	SMTPMailService supports SMTP authentication using user and password
0132102	Trace files STDOUT.TXT, STDERR.TXT and console-log.txt need to be UTF8 encoded
0132296	Add external XML schema validation to XMLEditor, so XML files not containing and schema location can be validating using an external XSD file.
0132297	Add XMLSchema validation support to SOAPAgentService, so SOAP request and response envelopes can be validated
0132301	Add XMLSchema validation support to SOAPServerService, so SOAP request and response envelopes can be validated
0132387 0132208	Add PASSWORD(*NONE) feature to PDF services Allow PDFDocumentService and PDFSpoolFileService to create a permission protected document with no open document password
0132443	Enhance CLRJSM command to keep last number of specified days CLRJSM INSTANCE(DEFAULT) TRACEDIR(YES) TEMPDIR(*YES) KEEP(7)
0132480	Improve OpenLDAPService referral error handing. Catch LDAPExceptions when reading search results.
0132576	Use sorted keystore aliases in PKIEditor and Studio view keystore
0132606	FTP services should use PASV host and not CONNECT host. Normally the connected IP address is the same as the IP address returned by the PASV subcommand. But this is not always the case.
0132652	Add FTPSocketManager to FTPService SSL support Options: ftp.ssl.factory ftp.ssl.provider ftp.ssl.protocol ftp.ssl.keyStore ftp.ssl.keyStoreType ftp.ssl.keyStorePassword ftp.ssl.keyAlias ftp.ssl.keyAlgorithm ftp.ssl.trustStore ftp.ssl.trustStoreType ftp.ssl.trustStorePassword ftp.ssl.trustAlgorithm ftp.ssl.trustServer
0132653	Improve HTTPSocketManager configuration options Options: http.ssl.factory http.ssl.provider http.ssl.protocol http.ssl.keyStore http.ssl.keyStoreType http.ssl.keyStorePassword http.ssl.keyAlias http.ssl.keyAlgorithm http.ssl.trustStore http.ssl.trustStoreType http.ssl.trustStorePassword http.ssl.trustAlgorithm http.ssl.trustServer
0132654	Sort FTPService directory and file LIST result
0132662	Add pathing encoding support to FTPService CONNECT HOST (...) ENCODING(...)
0132697	Recode SFTPService to use JCraft JSch classes
0132710	Update JavaMail to version 1.4.1
0132711	Update Axis to version 1.4 Nov 19 build
0132803	Replace console.timeout.repeat and console.timeout.wait properties with shutdown.controlled.repeat and shutdown.controlled.wait. Also change Studio and Console messages to reflect the ability to do shutdown reboot, shutdown immediate and shutdown controlled
0132843	SOAPAGENT SAMPLE RDML SET PARAMETER missing when parameter is a fixed value Have SAMPLE RDML code generator add SET PARAMETER command when parameter is a fixed value
0132948	Trace field definitions for RDMLX lists to inprove debug
0132975	Add more tracing to PDFDocumentService - trace color and annotation creation
0132984	Change PDF document element nonfullscreen page mode attributes Add new document nonfullscreen-page-mode attribute attribute. Obsolete nonfullscreenpagemode-useone, nonfullscreenpagemode-useoutlines, nonfullscreenpagemode-usethumbs, nonfullscreenpagemode-useoc
0133044	Do not uppercase SVHEAD resource value when used in a WRITE command This allows the fields specified by the svhead property to remain in the same case when used in the SV output file.
0133108	POP3MailService: response msg for GET *FROMADDRESS doesn't show address Trace the from address
0133138	Add Basic Authentication code generation option to SOAP Agent Wizard to allow enable or disable of this feature
0133161	Use new iText PdfWriter permission ALLOW_xxx constants to keep track with changes in iText classes.
0133256 0133206	HTTPService SERVICE_LOAD ARCHIVE AUTODETECT encoding exception When XML conent needs to be archived on the SERVICE_LOAD command and the Content-Type does not include a charset an UnsupportedEncodingException AUTODETECT is thrown
0133349	SERVICE_LOAD TRACE(YES) does not disable error tracing If for example you have service error tracing enabled for all services. manager.properties trace.service.error.address=all At the SERVICE_LOAD SERVICE(xxx) TRACE(xxx) command level : For no TRACE keyword, service error tracing is enabled, via the trace.service.error.address property. For TRACE(NO) service tracing is not started for this service. For TRACE(YES) service tracing is started for this service. ( Bug - error tracing is enabled, via the trace.servce.error.address property ) For TRACE(*ERROR) service tracing is started for this service and tracing deleted if no errors.
0133350	Allow custom message handler to be modify the SOAP Agent request and response SOAP XML messages.
0133351	Removed unused Axis directives from the Axis client and server deployment files Also add extra axis log4j entries to log4j.properties
0133375	Add support for IANA encoding UTF-16
0133376	Add more classes to the Startup load class logic to improve service startup time.
0133399	Protocol buffer being sized by length of content, this should not be the case UserAgent HTTP protocol buffer being sized by length of content, this should not be the case.
0133400	Refactor HTTP send protcol and content logic to reduce the number of objects being created
0133429	When a Studio download is done, show Download panel
0133441	Replace exception getMessage getClass logic with just the exception toString method
0133504	Refactor Command parser to reduce the number of object creations
0133514	Add support for NormalizedString types to SOAPAgent to increase the number of mappable XSD schema types
0133562	Improve SOAP Wizard generated RDML and RDMLX code samples
0133595	UserAgent property source.open does not use correct directory for source file lookup
0133596	Improve XMLBinding Wizard generated RDML and RDMLX code samples
0133680	Improve JSONBinding Wizard generated RDML and RDMLX code samples
0133702	Studio Proxy and Direct panel, disable New, Edit, SendTo, Delere popup menu items when mulitple rows are selected
0133775	Change JSMPXYEXT CL program MESSAGE parameter size to 256
0133776	Add CONTINUE and MESSAGE parameters to JSMDRTEXT CL program
0133777	Change JSMProxy program to pass a MESSAGE parameter of 256 bytes to JSMPXYEXT CL program
0133778	Change JSMDirect program to pass CONTINUE and MESSAGE parameters to JSMDRTEXT CL program If a CONTINUE value of N is received from JSMDRTEXT program, the JSMDirect program will not continue and will return the MESSAGE value as a HTML response
0133788	Change JSMADMEXT CL program MESSAGE parameter size to 256
0133794	Add CONTINUE and MESSAGE parameters to JSMLSAEXT CL program
0133795	Increase size of DC@W30 LIMIT field from Packed 8,0 to Packed 10,0
0133797	Increase Studio Proxy Edit dialog, limit field from 8 to 10
0133801	Allow binding services to bind more than once to inbound content XMLBindQueueService XMLBindFileService HTTPInboundXMLBindService HTTPOutboundXMLBindService JMSXMLBindService
0133841	Resize initial buffer sizes used in XML declaration parsing
0133897	EDIDataSet Include table name when tracing format script and class assigments Include table name when tracing format script and class assigments in EDIDataSetService
0133905	EDI X12 decimal type R elements should have trailing zeroes removed
0133972	Trace the use of obsolete service names, so the end user can replace these service names with the latest name. For example: FTPClient should be FTPService.
0133986	ExcelReadService - suppress warning messages
0133989	Template book must be closed after closing the wite book. Refactor closing of read, write and template books.
0133995	Increase Windows JSMProxy dc_w30 file limit field size from 8 to 10
0134002 0134134	Requesting FORMATTING enhancement in the ExcelReadService This feature has be added to ExcelReadService
0134008	Add proxy request method *ANY to allow any HTTP request method to pass through to the JSMDirect program
0134010	Allow Windows jsmproxy.exe to pass any HTTP request method
0134053	Allow outbound HTTP services to send any HTTP request method, so REST style application can be developed
0134063	Calculate BASE64 encoder buffer sizes using content length to reduce memory usage
0134076	Trace time spent creating JavaScript context for XML binding services to improve debug
0134113	Create XMLReaderService based on STAX to improve the variety of ways to process XML files.
0134114	Improve XML entity resolver logic to handle relative paths
0134137	Create XMLWriterService based on STAX to improve the variety of ways to create XML files.
0134202	SMTPMailService - Trace default HELO name to improve debug
0134215	ExcelReadService workbooking settings. Set initial file size to size of file to reduce the amount of memory.
0134222	UserAgent - workbooking settings. Set initial file size to size of file to reduce the amount of memory.
0134282	Refactor Studio HTTP request logic to reduce object creation
0134331	Allow Studio to create manager.properties authorized users to simplify the process of creating authorised users.
0134347	RDML - Modify QUSCRTUS API usage to set optimum space aligment to "0" V6R1 now defaults optimum space aligment to "1", this reduces the max size of userspace content.
0134392	SMTPMailService - Trace recipients X509 certificate to improve debug
0134434	Allow directory import and export of certificates from a keystore to improve usability.
0134496	Add more features to PKIEditor and Studio PKI viewers to improve usability
0134531	Allow SQLService to call procedures with IN, OUT and INOUT parameters
0134610	Allow FTP services to return date, time and size data with listing
0134611	Add SOAP and JSON Types to Repository Viewer, so these Data Types can be maintained at a central point and distributed to local Studio Project copies.
0134706	Allow image viewer to copy image to clipboard for other Window application to access
0134724	Add support for MIME types MPEG and MPEG4 to HTTP services to MPEG4 files can be sent.
0134777	Add append content capability to InboundFileHandler and InboundMultipartHandler RECEIVE command, to allow content to be appended to an existing file.
0134903	Add SOCKS support to Studio UserAgent to allow HTTP and HTTPS connection to go via a SOCKS proxy server. Only SOCKS protocol 4 and 4A are supported.
0134922	Allow Studio UserAgent to send custom HTTP protocol methods. This allows methods such as GET, HEAD, TRACE, OPTIONS, POST and used-define methods to be used.
0134947	UserAgent to support GET method for different transports. This allows MQ messages and FTP file to be received from the host.
0134948	UserAgent FTP put should have send the data source not the file content. The transfer content was taken directly from the local file and not the data source panel content.
0134971	Add sftp transport to Studio UserAgent. This allows get and put of files using the SSH2 protocol.
0134980	Allow selected pages to be specified on the PDFDocumentService import element. Instead of the sigle page number. A comma-seperated list of pages and page ranges can now be specified.
0135104	Add exit program RUNJSMEXT to RUNJSM program. This allows user-defined CL programs to be executed before and after the Java environment executes.
0135106	Add import-image element to PDFDocumentService This allows a single image to be imported into a page, scaled and centered to fill the page margins.
0135143	Add PUBLIC keyword to XML bind service WRITE command. The DOCTYPE keyword is used to specify the DOCTYPE SYSTEM value. The PUBLIC keyword is used to specify the public component of the DOCTYPE declaration.
0135158	Add more JDK's to STRJSM VERSION keyword choice This allows IBM JDK's 5 and 6 ( 32 and 64 bit versions ) to be used.
0135204	Replace URL class with IUAURL class for UserAgent URL parsing. The URL class is too restrictive on the protocol types allowed.
0135247 0134895 0135224	Improve ExcelReadService and UserAgent reading cell number values Improve the double to string conversion logic Add support to specify a general number cell scale. UserAgent property excel.scale=4 ExcelReadService READ command keyword SCALE
0135259	Add remove trailing zeroes logic to Zoned and Packed varaibles. This allows Zoned and Packed fields to accept values that have unnecessary trailing zeroes.
0135370	Allow all wizards and editors to remember last window location and size When a wizard or editor is started it will use the last window location and size
0135372	Add entity and node find capability to JSON and XMLBinding Wizards This enhancement makes it easier to find entities with in the tree structure.
0135392	XML tranformation wizard did not mark duplicate list elements Mark list child elements for other duplicate XML element entries
0135503	XMLBinding services cannot read elements when the default ns has been removed Change the XMLBindingWizard to generate the correct namespace path and to consider the presence of xmlns="' in the XML document.
0135550	Update Bouncy Castle to version 1.4.0, iText to version 2.1.3 and jGoodies to version 2.2.0
0135638	Fix Excel Cell format color names Change cell color name TURQOISE to TURQUOISE. Also use equalsIgnoreCase method when matching FORMAT keyword values.
0135661	Add CONTENT-LENGTH to HTTP properties
0135668	Add additional trace messages to ExcelReadService
0135672	Replace FileChannel with read bytes, as FileChannel uses too much memory
0135680	Enhance upgrade logic to keep SystemDefault.properties #AllowOptions line
0135722	HTTPInboundXMLBindService and HTTPInboundJSONBindService GET PROPERTY command does not return property value in #JSMMSG field
0135731	Add tracing to HTTP bind query functionality Trace binding keyword and values. Also replace FunctionBindHelper.bindQueryString with HTTPHelper.bindQueryString method
0135747	Remove the Direct database disable of WSDL field for windows jsmadmin updates. Windows JSMAdmin did not have complete functionality in the last release, so the WSDL feature was disabled.
0135768 0135759	Allow XML Binding services to send multiple field mappings A single LANSA field could be mapped to multiple elements in one fragment. Allow this scenario to occur.
0135805	Create certificate subject names using UTF8String types Enhance Studio PKIEditor to create certificate subject names using UTF8String types
0136048 0129210 *	New columns in DC_W29 support requests through JSMDIRECT for WSDL and RDMLX Using this new support, Web service clients can now request the WSDL for a published web service through the JSMDIRECT interface.

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 Nov 19 build	All
jsmbcmail.jar	LANSA Integrator Instance jar directory - Bouncy Castle 1.4.0	All
jsmbcpg.jar	LANSA Integrator Instance jar directory - Bouncy Castle 1.4.0	All
jsmbcprov.jar	LANSA Integrator Instance jar directory - Bouncy Castle 1.4.0	All
jsmcomdisc.jar	LANSA Integrator Instance jar directory - Axis commons-discovery 0.4	All
jsmcomlib.jar	LANSA Integrator Instance jar directory - Axis commons-logging 1.1	All
jsmedimap.jar	LANSA Integrator Instance jar directory	All
jsmide.jar	LANSA Integrator Instance jar directory	All
jsmjaf.jar	LANSA Integrator Instance jar directory - Java Activation Framework 1.1.1	All
jsmjaxrpc.jar	LANSA Integrator Instance jar directory - Axis JAXRPC 1.1	All
jsmldap.jar	LANSA Integrator Instance jar directory - Open LDAP 2008-03-01 build	All
jsmlog4j.jar	LANSA Integrator Instance jar directory - Axis Log4j 1.2.15	All
jsmmail.jar	LANSA Integrator Instance jar directory - Java Mail 1.4.1	All
jsmnative.jar	LANSA Integrator Instance jar directory	All
jsmpdf.jar	LANSA Integrator Instance jar directory - iText 2.1.3	All
jsmpdfcjk.jar	LANSA Integrator Instance jar directory - iText fonts	All
jsmrfi.jar	LANSA Integrator Instance jar directory	All
jsmsaaj.jar	LANSA Integrator Instance jar directory - Axis SAAJ 1.2	All
jsmscript.jar	LANSA Integrator Instance jar directory - Rhino 1.6.7	All
jsmserializer.jar	LANSA Integrator Instance jar and endorsed directories - Xerces 2.7.0	All
jsmservice.jar	LANSA Integrator Instance jar directory	All
jsmsoap.jar	LANSA Integrator Instance jar directory	All
jsmssh2.jar	LANSA Integrator Instance jar directory - JSch 1.39	All
jsmstax.jar	LANSA Integrator Instance jar directory - Woodstox 3.2.4	All
jsmstaxapi.jar	LANSA Integrator Instance jar directory - Woodstox 1.0.1	All
jsmutil.jar	LANSA Integrator Instance jar directory	All
jsmwsaddr.jar	LANSA Integrator Instance jar directory - Axis WS-Addressing 1.0	All
jsmwsdl4j.jar	LANSA Integrator Instance jar directory - Axis WSDL4J 1.6.2	All
jsmwssec.jar	LANSA Integrator Instance jar directory - Axis WS-Security 1.5.3	All
jsmxalan.jar	LANSA Integrator Instance jar and endorsed directories - Xalan 2.7.0	All
jsmxerces.jar	LANSA Integrator Instance jar and endorsed directories - Xerces 2.8.1	All
jsmxls.jar	LANSA Integrator Instance jar directory - jXL 2.6.8	All
jsmxmlapi.jar	LANSA Integrator Instance jar and endorsed directories - Xerces 1.3.03	All
jsmxmlsec.jar	LANSA Integrator Instance jar directory - Axis XML-Security 1.4.1	All

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

Object Name	Object Type	Library
QCLSRC	*PF	*JSMLIB
QCMDSRC	*PF	*JSMLIB
QDDSSRC	*PF	*JSMLIB
QRPGLESRC	*PF	*JSMLIB
DC@D8700	*DSPF	*JSMLIB
DC@P8700	*PGM	*JSMLIB
JSM	*DSPF	*JSMLIB
JSM	*MSGF	*JSMLIB
JSM	*MENU	*JSMLIB
JSMMSGF	*MSGF	*JSMLIB
CHGJSMAUT	*PGM	*JSMLIB
CHGJSMDFT	*PGM	*JSMLIB
CHGJSMOWN	*PGM	*JSMLIB
CLRJSM	*PGM	*JSMLIB
CRTJSMSBS	*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
JSMGETENV	*PGM	*JSMLIB
JSMGETPORT	*PGM	*JSMLIB
JSMLINK	*PGM	*JSMLIB
JSMMQDEPTH	*PGM	*JSMLIB
JSMMQGET	*PGM	*JSMLIB
JSMMQPUT	*PGM	*JSMLIB
JSMOWNER	*PGM	*JSMLIB
JSMPENDING	*PGM	*JSMLIB
JSMPROXY	*PGM	*JSMLIB
JSMTRCENV	*PGM	*JSMLIB
OPTJSM	*PGM	*JSMLIB
RUNJSM	*PGM	*JSMLIB
WRKJSM	*PGM	*JSMLIB
DCXS882X	*SRVPGM	*JSMLIB
DCXS883X	*SRVPGM	*JSMLIB
JSMDTAQ	*SRVPGM	*JSMLIB
JSMMGRSRV	*SRVPGM	*JSMLIB
JSMMSGQ	*SRVPGM	*JSMLIB
JSMRPGSRV	*SRVPGM	*JSMLIB
JSMUSRSPCE	*SRVPGM	*JSMLIB
LIBLSSRV	*SRVPGM	*JSMLIB
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
JSMCLTDTA	*DTAARA	*JSMLIB
JSMDRTDTA	*DTAARA	*JSMLIB
JSMMGRDTA	*DTAARA	*JSMLIB

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 EPC835.
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 JSMADMEXT, JSMDRTEXT, JSMLSAEXT, JSMPXYEXT, STRJSM program and STRJSM command has changed. These programs are automatically compiled during the EPC installation. Prior to applying the EPC, you should make a backup of these objects if you have made custom changes to them. Refer also to Additional Install Notes (iSeries) for post installation steps.

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.
EPC835 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 EPC835
copy unzipped file EPC835 to folder EPC835

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 EPC835
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 EPC835 : enter command cd EPC835
to send the downloaded file to the iSeries : enter command put EPC835
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 EPC835 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(EPC835) 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:

LOADEPC835 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)

If custom changes are required to the STRJSM program, the changes should be applied and affected source files should be recompiled. A sample is provided in file QCLSRC.
If custom changes are required to the exit programs JSMADMEXT, JSMDRTEXT, JSMLSAEXT and JSMPXYEXT , the changes should be applied and then the affected source files should be 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 EPC835.
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) EPC835w.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_EPC835.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_EPC835.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>
The PKI Editor no longer requires the 3rd party jar files from Phaos Technology. Bouncy Castle is now used and these jar files are shipped with Studio.
When using the Studio application, several obsolete directories and files will be renamed or deleted when a project is opened or a wizard is executed.
The SOAP Wizard, JSON Wixard, XML transformation and binding Wizards will execute remove obsolete project solution files when they are started.

The following files will be removed from the project solution directory:

    XML_TRACE.TXT
    XML_COMPILE.TXT
    JSON_TRACE.TXT
    JSON_COMPILE.TXT
    SOAP_TRACE.XT
    SOAP_COMPILE.TXT
    SOAP_WSDL.XT

The following directories will be removed from the project solution directory:

    xsl-compile
    xml-compile
    json-compile
    xsl-source      ( if empty )
    soap-compile ( if empty )

If the soap-compile directory exists and contains files, it will be renamed to compile-agent.
This the safest option to preserve the contents of the soap-compile directory.
It is standard practice to have only one SOAP project per solution directory.
If the solution directory is being used for a SOAP server project, then it is ok to delete the soap-agent directory as it is not used and will only contain old SOAP server generated code.