A NotFoundException is thrown when trying to delete the last record of a VSAM file using VSE Connector Server and VSAM-via-CICS service. The record is being deleted, but the NotFoundException is thrown because the subsequent positioning does not work.
Exclusive lock not released after update of a VSAM record through VSAM-via-CICS Service. This can cause other tasks to wait until the file is closed.
Under some circumstances the VSE SOAP Engine formats outgoing decimal type values incorrectly. When the specified precision and the packed decimal values would lead to a value like 0.xy, the incorrect output would be X.xy instead.
When the VSE SOAP Engine receives a SOAP request that contains a SOAP header, it fails to parse the SOAP request. As a result, an incorrectly formatted SOAP response is sent back with Faultdetail="No method to execute".
The XML Parser fails to parse tags with names that are only one character long (e.g. <x>). In this case error code NOT_WELL_FORMED (1) is returned.
During open processing for a VSAM cluster, the VSE Connector Server checks if an label for the file is already existent and sufficient. If not, a temporary partition label named TMPnnnn is created. Due to incorrect checking existing labels are not detected if the corresponding catalog label name is shorter than 7 characters and the label area is on VDISK. This causes the creation of a temporary label on each open and can fill up the label area if too many labels are created.
Other misc problems:
Problems when using LOCATE mode with redirected VSAM cluster.
Incorrect key position and length is used when accessing a redirected VSAM cluster via an alternate index.
Problems when using VSAM Redirector with compressed clusters.
Performance degradation with VSAM Redirector due to improper use of GETVIS/FREEVIS SVCs.
VSE Connector Server partition runs out of GETVIS when using VisualAge Generator ITF access to many VSAM files due to use of dataset name sharing with 255 strings.
Misc problems in VSE SOAP engine, XML parser and HTTP client:
Handling of UTF-8 encoded SOAP requests has been corrected. The SOAP engine now retrieves and sends the HTTP content in binary and translates it using LE iconv (please also install LE APAR PK19360).
VSE XML parser has been enhanced to support XML entities. (Requirement MR0428053442).
VSE SOAP Engine has been enhanced to support data types decimal, date, time and arrays. Decimal SOAP parameters are now represented as packed decimal with implied decimal point. (Requirement MR0715051311).
HTTP client has been corrected to allow connections through a proxy server.
HTTP client has been corrected to generate correct HTTP header 'accept-charset'.
VSE SOAP interface has been enhanced to allow he use of longer method names (up to 128 chars). The interface is backward compatible, i.e. existing programs will work without changes.
Note: Due to changes in C header files IESHTTPH.h, IESSOAPH.h, IESXMLAH and IESXMLPH, you may need to adapt and recompile your programs, when they makes use of the VSE SOAP engine, XML parser and HTTP client.
Several problems with VSE SOAP (Web Services) Support:
Improper details in SOAP Fault message: In case a SOAP converter or SOAP user program returned an error code, the SOAP fault message now contains the return code in the detail text.
Progck in IESSOAPD due to invalid user TS-Queue entry: An incorrectly formated user TS-Queue entry caused a trap in the SOAP code when the entry is being processed. Now a routine has been added to verify the format of the entry prior to the processing of that entry. In case an invalid entry is detected, an return code (INVALID_PARAM) is returned.
Missing codepage choice for SOAP/HTTP communication: Support for specifying ASCII and EBCDIC codepages has been added. The codepages can be specified in the SOAP option phase IESSOAPO (details see below).
SOAP Methods without XML namespaces are considered as invalid: Usualy the SOAP method is prefixed with an XML namespace <ns1:getQuote xmlns:ns1="urn:iessoapd:getquote" ... . Some SOAP clients do not prefix the method: <getQuote xmlns="urn:iessoapd:getquote" ... . Code has been changed to accept such requests using the default namespace.
GETVIS leak leads to CICS Short on storage: Incorrect use of EXEC CICS FREEMAIN caused a GETVIS leak. Code has been corrected to free th storage correctly.
Missing SOAP-Action HTTP header in SOAP Client: When sending a SOAP request over HTTP, an HTTP-Header line called SOAP-Action is needed by some SOAP servers. Code has been enhanced to send this HTTP header line.
XML parser does not accept single quotes in attributes: XML attributes are usually enclosed in double quotes ("). Some XML documents use single quotes for attributes. The code has been changed to support both, double and single quotes.
Enhancements of SOAP/HTTP trace using option phase IESSOAPO: The trace support of SOAP support and HTTP client has been enhanced. Now the trace options are specified in the SOAP option phase IESSOAPO. The SOAP code tries to load this phase. If the phase is not available, trace is deactivated. Inside the phase, several options can be specified, including trace flags and code pages. The following job can be used to assemble the IESSOAPO option phase: IESSOAPO.job
You must define the program IESSOAPO to CICS before you can use it. Use CEDA DEFINE PROGRAM(IESSOAPO) to define the program. Language is Assembler.
Note: Due to changes in C header file IESHTTPH.h, you may need to adapt and recompile your programs, when they makes use of the VSE HTTP client.
Using VSE XML parser IESXMLAP causes a GETVIS leak when called multiple times from one program:
When the VSE XML parser IESXMLAP is used to parse multiple XML documents in the same program, a GETVIS leak occours. This is caused by duplicate fetchep() calls inside the parser.
Performance Problem with VSE Connector Server if many standard labels are available and other misc problems.
VSEConnectors: Now using new LABEL function to search for a label by given file-id. This requires AF APAR DY46070. If this APAR is not applied, the old mechanism will be used.
VSAM Redirector: Corrected handling of SOCKET SEND to support BSI TCP/IP Stack.
Added support for REUSE (new method VSAMFileInfo.isReuse() ).
HTTP: Now ISO8859-1 Codepage is the default ASCII codepage. If any other charset is specified in the HTTP header it will be used, if available. LE APAR PQ87058 to avoid traps during iconv_open() when an invalid or unknown codepage is specified.
VSE Connectors: Corrected date handling in VSAM, LIBR, ICCF and POWER interfaces. To make sure the correct date format is used, set the COUNTRY parameter in CEEDOPT accordingly. E.g. if you are in the USA and you use US date format MM/DD/YY, specify: COUNTRY=((US),OVR). If you are in Germany and you use the German date format DD/MM/YY specify: COUNTRY=((DE),OVR).
VSE Connectors: Adding or changing a VSAM field definition with an empty description will no longer create unnecessary records in the mapping repository IESMAPD. In addition the repository is being cleaned from these empty description records when it is opened for update he first time.
VSE Connectors: Enhanced clean utility IESVSDCL to remove empty description records.
VSE Connectors: Using buffered sends for transmitting new console messages.
VSAM Redirector: Added support for multible string applications (e.g. CICS). Now the string ID is sent to the VSAM Redirector Server ATTENTION:
Due to a protocol change with this support the VSAM Redirector Server must be updated also. This code will NOT run with older versions of VSAM Rediector Server!
Due to a interface change of the redirector handler interface you must recompile and adapt your handlers! Please have a look at the sample handlers and the javadoc.
VSE Script: minior fixes.
VSE SOAP: Add support to set tracing of the VSE SOAP implementation and the HTTP client on or off via TS-Queue entry. To activate the Trace, insert the following entry into a TS-Q named IESSOAPT: 'SCED0000'. To activate the trace of the HTTP client, add entry 'H0000000' into TS-Q IESHTTPT. You may do this using one of the following commands:
VSE Connectors: A missing security check allows to access VSE Connector Server plugins to be executed although a previous logon was not successful or no logon was performed at all.
Visual Age Generator: The VSE Connector Server plugin IESVSAPL now uses dataset name sharing to open a VSAM file. This allows to open a VSAM file more than once for update.
VSE Connectors: Accessing compressed VSAM clusters does not work correct because of invalid record length and key position information returned by VSE Connector Server.
VSAM Redirector: Problem with VSAM Redirector when processing a DELETE request and OWNER=REDIR.
VSE Virtual Tape: Enhancements of remote Virtual Tape server.
VSEConnectors: Enhancements of VSAM JDBC Driver.
VSE Script: minior fixes.
VSE SOAP and VSE Connector: recompile of C sources due to use of wrong compiler level.
Misc problems in VSE SOAP engine, XML parser and HTTP client:
Handling of UTF-8 encoded SOAP requests has been corrected. The SOAP engine now retrieves and sends the HTTP content in binary and translates it using LE iconv (please also install LE APAR PK19360).
VSE XML parser has been enhanced to support XML entities. (Requirement MR0428053442).
VSE SOAP Engine has been enhanced to support data types decimal, date, time and arrays. Decimal SOAP parameters are now represented as packed decimal with implied decimal point. (Requirement MR0715051311).
HTTP client has been corrected to allow connections through a proxy server.
HTTP client has been corrected to generate correct HTTP header 'accept-charset'.
VSE SOAP interface has been enhanced to allow he use of longer method names (up to 128 chars). The interface is backward compatible, i.e. existing programs will work without changes.
Note: Due to changes in C header files IESHTTPH.h, IESSOAPH.h, IESXMLAH and IESXMLPH, you may need to adapt and recompile your programs, when they makes use of the VSE SOAP engine, XML parser and HTTP client.
Several problems with VSE SOAP (Web Services) Support:
Improper details in SOAP Fault message: In case a SOAP converter or SOAP user program returned an error code, the SOAP fault message now contains the return code in the detail text.
Progck in IESSOAPD due to invalid user TS-Queue entry: An incorrectly formated user TS-Queue entry caused a trap in the SOAP code when the entry is being processed. Now a routine has been added to verify the format of the entry prior to the processing of that entry. In case an invalid entry is detected, an return code (INVALID_PARAM) is returned.
Missing codepage choice for SOAP/HTTP communication: Support for specifying ASCII and EBCDIC codepages has been added. The codepages can be specified in the SOAP option phase IESSOAPO (details see below).
SOAP Methods without XML namespaces are considered as invalid: Usualy the SOAP method is prefixed with an XML namespace <ns1:getQuote xmlns:ns1="urn:iessoapd:getquote" ... . Some SOAP clients do not prefix the method: <getQuote xmlns="urn:iessoapd:getquote" ... . Code has been changed to accept such requests using the default namespace.
GETVIS leak leads to CICS Short on storage: Incorrect use of EXEC CICS FREEMAIN caused a GETVIS leak. Code has been corrected to free th storage correctly.
Missing SOAP-Action HTTP header in SOAP Client: When sending a SOAP request over HTTP, an HTTP-Header line called SOAP-Action is needed by some SOAP servers. Code has been enhanced to send this HTTP header line.
XML parser does not accept single quotes in attributes: XML attributes are usually enclosed in double quotes ("). Some XML documents use single quotes for attributes. The code has been changed to support both, double and single quotes.
Enhancements of SOAP/HTTP trace using option phase IESSOAPO: The trace support of SOAP support and HTTP client has been enhanced. Now the trace options are specified in the SOAP option phase IESSOAPO. The SOAP code tries to load this phase. If the phase is not available, trace is deactivated. Inside the phase, several options can be specified, including trace flags and code pages. The following job can be used to assemble the IESSOAPO option phase: IESSOAPO.job
You must define the program IESSOAPO to CICS before you can use it. Use CEDA DEFINE PROGRAM(IESSOAPO) to define the program. Language is Assembler.
Note: Due to changes in C header file IESHTTPH.h, you may need to adapt and recompile your programs, when they makes use of the VSE HTTP client.
Using VSE XML parser IESXMLAP causes a GETVIS leak when called multiple times from one program:
When the VSE XML parser IESXMLAP is used to parse multiple XML documents in the same program, a GETVIS leak occours. This is caused by duplicate fetchep() calls inside the parser.
Performance Problem with VSE Connector Server if many standard labels are available and other misc problems.
VSEConnectors: Now using new LABEL function to search for a label by given file-id. This requires AF APAR DY46070. If this APAR is not applied, the old mechanism will be used.
VSAM Redirector: Corrected handling of SOCKET SEND to support BSI TCP/IP Stack.
Added support for REUSE (new method VSAMFileInfo.isReuse() ).
HTTP: Now ISO8859-1 Codepage is the default ASCII codepage. If any other charset is specified in the HTTP header it will be used, if available. LE APAR PQ87058 to avoid traps during iconv_open() when an invalid or unknown codepage is specified.
VSE Connectors: Corrected date handling in VSAM, LIBR, ICCF and POWER interfaces. To make sure the correct date format is used, set the COUNTRY parameter in CEEDOPT accordingly. E.g. if you are in the USA and you use US date format MM/DD/YY, specify: COUNTRY=((US),OVR). If you are in Germany and you use the German date format DD/MM/YY specify: COUNTRY=((DE),OVR).
VSE Connectors: Adding or changing a VSAM field definition with an empty description will no longer create unnecessary records in the mapping repository IESMAPD. In addition the repository is being cleaned from these empty description records when it is opened for update he first time.
VSE Connectors: Enhanced clean utility IESVSDCL to remove empty description records.
VSE Connectors: Using buffered sends for transmitting new console messages.
VSAM Redirector: Added support for multible string applications (e.g. CICS). Now the string ID is sent to the VSAM Redirector Server ATTENTION:
Due to a protocol change with this support the VSAM Redirector Server must be updated also. This code will NOT run with older versions of VSAM Rediector Server!
Due to a interface change of the redirector handler interface you must recompile and adapt your handlers! Please have a look at the sample handlers and the javadoc.
VSAM Redirector: Added DD name and partition filter for VSE/ESA 2.6. Now the IESRDENT macro allowes to specify DD names (labels) for cluster and catalog. It also allowes to specify a partition ID (e.g. F2) as filter.
A missing security check allowes to access VSE Connector Server plugins to be executed although a previous logon was not successful or no logon was performed at all.
Miscellaneous problems in the VSE Connector Client code.
For all VisualAge Generator users using VSAM remote access in ITF.
The VSE Connector Server plugin IESVSAPL now uses dataset name sharing to open a VSAM file. This allwes to open a VSAM file more than once for update. Note: This PTF requires LE APAR PQ69314.
Due to a level of the C Compiler used to compile C modules in the GA version of VSE/ESA 2.6.0 S/390 instructions with a opcode of e.g. x'A7' were generated. These instructions require at least the following hardware
S/390 Parallel Enterprise Server 9672 Rx2
Multiprise 2000/3000
P390/R390
Integrated Server
In case a customer is running another hardware system (e.g. ES/9221 or 9672-Rx1) the usage of these C modules could esult in 'operation exception' errors.
C modules are used in the following components of VSE/ESA 2.6:
VSE Central Functions (Virtual Tape Server, TCP/IP Key Verification)
VSE Connectors: Corrected date handling in VSAM, LIBR, ICCF and POWER interfaces. To make sure the correct date format is used, set the COUNTRY parameter in CEEDOPT accordingly. E.g. if you are in the USA and you use US date format MM/DD/YY, specify: COUNTRY=((US),OVR). If you are in Germany and you use the German date format DD/MM/YY specify: COUNTRY=((DE),OVR).
VSE Connectors: Using buffered sends for transmitting new console messages.
A missing security check allowes to access VSE Connector Server plugins to be executed although a previous logon was not successful or no logon was performed at all.
For all VisualAge Generator users using VSAM remote access in ITF.
The VSE Connector Server plugin IESVSAPL now uses dataset name sharing to open a VSAM file. This allwes to open a VSAM file more than once for update. Note: This PTF requires LE APAR PQ69314.
Updating a VSAM record containing packed decimal fields may fail with a ConcurrentUpdateException at method VSEVsamRecord.commit(). This is caused by a sign nibble value of X'F' instead of X'C'.
Execution of the ExecuteJob request (VSEPower.executeJob() method) can cause a internal dispatcher loop under some timeout circumstances.
The Display Activity Plugin causes a internal dispatcher loop while gathering activity data. The Display Activity Plugin seems to hang after first measurement interval.
When using methon VSEVsamCluster.selectRecords() with filter(s) that consists of a field of type SIGNED, UNSIGNED or PACKED, the filter did not work correctly. The result was that no recor matches the filter.
LocateFilter was not working correctly with filter <=. Select did start at filter value instead of starting at first record.
Select did not terminate when filter < or <= is used with key, and the value of the key is greater than the specified filter value. Instead the file was read until EOF was reached.
Browsing large VSAM catalog takes very long time. This applies also for very fragmented catalogs (i.e. there are a lot of deleted records within the catalog).
Now automatically adding a temporary partition label for the master catalog before opening. This solves the problem with opening the master catalog when a IJSYSUC is present in the standard labels.
ClusterList Request-handler has been optimized when retriving information about a single cluster.
Added SocketBuffer-Trace. It can be enabled via SETTRACE command.
Added tracing for VSAM Open errors It can be enabled via SETTRACE
command.
Added line content to message "IESC1017E SYNTAX ERROR IN CONFIG FILE: <filename>". Now displaying the line in error.
Integerated into VSE/ESA 2.6, included in VSE/ESA 2.5.2 refresh.
