IBM Support

IBM: z/VSE - Service and support - Corrective - VSE Conn - Unsupported release

General Page

IBM: z/VSE - Service and support - Corrective - VSE Conn - Unsupported release

z/VSE Connectors

Back to top

Unsupported release: z/VSE Connectors 9.3 APARs for z/VSE V6.1

Last update: February 6, 2018

APAR
Date		 PTF Contents
PI92814
2018/02		 UI53403 The VSE VTAPE Server does not allow two or more VTAPEs from the same IP address and for the same CUU at the same time. This can happen when multiple z/VSE systems are connecting to the VTAPE Server through one Fast Path to Linux on System z (LFP) system, or through one z/VM VSE IP Assist (VIA) system, or through one z/VSE Network Appliance (VNA) system, so that those z/VSE systems appear under the same IP address to the VTAPE Server.
Note: Above update affects the workstation code (Component 5686-VS6-38). Please download from here and reinstall the component on your workstation.
PI88355
2017/12		 UI51983 The VSE Connector Server configured to use SSL/TLS may hang or drop the connection when uploading large amounts of data.
Note: If you are using TCP/IP for z/VSE V2.1 (CSI TCP/IP) it is recommended that you also install ZP218322 and ZP218323 for TCP/IP for z/VSE V2.1.
PI90168
2017/11		 UI52054 The VSE Connector Client fails to enable the TCP keep-alive option via the Java system property java.net.socket.KeepAlive. Setting this property to true should enable TCP keep alive on the underlying socket, but it does not do so.
Note: Above update affects the workstation code (Component 5686-VS6-38). Please download from here and reinstall the component on your workstation.
PI87713
2017/10		 UI50638 When performing an LDAP signon via the VSE Connector Server the second and any subsequent signon attempt fails with FDBK=112 when LDAP signon is configured to use SSL. While the LDAP signon attempt is using the cached password hash, it works. Once it needs to connect to the LDAP server for a second time, it fails while initializing the SSL library.
PI87690
2017/10		 UI50476 When a batch program that uses EXCI (External CICS Interface) also uses the VSAM Redirector (with EXIT='IESREDIR') it may receive EXCI error 419 (CICS_AFCB_PRESENT).
PI85232
2017/09		 UI50049 The z/VSE SOAP Engine V2 produces an invalid literal SOAP message.
PI81584
2017/05		 UI47276 The z/VSE SOAP Engine V2 working as client returns EIBRESP2=4 (INTERNAL ERROR) when calling IESOACLN when no HTTP proxy is configured in the rules used with the web service.
PI81522
2017/05		 UI47293 The VSAM Capture Exit (IESVSCAP) fails to connect to an WebSphere MQ server with MQCCODE=0002 MQRCODE=085B when operating with MODE=MQCLIENT.
PI64083
2016/07		 UI38636 The VSAM Redirector handler "DBHander" does not allow to specify additional connection properties in the JDBC URL for the Microsoft SQl Server JDBC Driver. It only allows to specify one singe connection property, which must be the "DatabaseName" property. Any additional properties are incorrectly treated as separate options of the OPTION string.
Note: Above update affects the workstation code (Component 5686-VS6-38). Please download from here and reinstall the component on your workstation.
PI51277
2016/02		 UI32442 The new z/VSE SOAP support, that was introduced in z/VSE 5.2 and now supports literal encoding style, does not correctly handle complex copybooks with REDEFINES and OCCURS clauses. The result is that fields are mapped to a wrong location in the commarea. This affects z/VSE as SOAP server as well as z/VSE as SOAP client.
Required action: After applying this PTF you MUST also update the CICS2WS tool to version 2.7.0 (or later). You MUST then re-generate any existing RULES with the new CICS2WS tool version of 2.7.0 (or later), assemble them on z/VSE and perform a NEWCOPY on them in CICS. The z/VSE SOAP Engine will only accept RULES generated with a CICS2WS tool version of 2.7.0 (or later).
Note: Users of the 'old' SOAP support using generated PROXY code are not affected and do not need to update the CICS2WS version. However the new CICS2WS version will also work with the 'old' SOAP support.
PI51690
2015/11		 UI32695 When updating, deleting or inserting a VSAM record using the VSAM-via-CICS service fails (e.g. due to a duplicate key error) then that VSAM file may become unusable for subsequent requests. This may affect other CICS programs accessing the VSAM file. It may also hinder the file from being closed in CICS via CEMT SET FILE CLOSED.
PI51278
2015/11		 UI32467 The z/VSE SNMP Monitoring Agent returns incorrect CPU-time values when the system is running with CPU balancing active. Whenever the CPU balancing algorithm starts or stops CPUs the CPU-time value reported by the SNMP Monitoring Agent is incorrect.

Back to top

z/VSE Connectors 9.3 components

Comp. ID CLC Description
5686-VS6-35 61N VSE Connectors
5686-VS6-38 61P VSE Connector WS code

Back to top

Unsupported release: z/VSE Connectors 9.2 APARs for z/VSE V5.2

Last update: February 6, 2018

APAR
Date		 PTF Contents
PI92810
2018/02		 UI53402 The VSE VTAPE Server does not allow two or more VTAPEs from the same IP address and for the same CUU at the same time. This can happen when multiple z/VSE systems are connecting to the VTAPE Server through one Fast Path to Linux on System z (LFP) system, or through one z/VM VSE IP Assist (VIA) system, or through one z/VSE Network Appliance (VNA) system, so that those z/VSE systems appear under the same IP address to the VTAPE Server.
Note: Above update affects the workstation code (Component 5686-CF9-38). Please download from here and reinstall the component on your workstation.
PI88354
2017/12		 UI51982 The VSE Connector Server configured to use SSL/TLS may hang or drop the connection when uploading large amounts of data.
Note: If you are using TCP/IP for VSE/ESA 1.5F (CSI TCP/IP) it is recommended that you also install ZP15F386 and ZP15F387 for TCP/IP for VSE/ESA.
PI90158
2017/11		 UI52053 The VSE Connector Client fails to enable the TCP keep-alive option via the Java system property java.net.socket.KeepAlive. Setting this property to true should enable TCP keep alive on the underlying socket, but it does not do so.
Note: Above update affects the workstation code (Component 5686-CF9-38). Please download from here and reinstall the component on your workstation.
PI87711
2017/10		 UI50637 When performing an LDAP signon via the VSE Connector Server the second and any subsequent signon attempt fails with FDBK=112 when LDAP signon is configured to use SSL. While the LDAP signon attempt is using the cached password hash, it works. Once it needs to connect to the LDAP server for a second time, it fails while initializing the SSL library.
PI85230
2017/09		 UI50048 The z/VSE SOAP Engine V2 produces an invalid literal SOAP message.
PI81583
2017/05		 UI47275 The z/VSE SOAP Engine V2 working as client returns EIBRESP2=4 (INTERNAL ERROR) when calling IESOACLN when no HTTP proxy is configured in the rules used with the web service.
PI81520
2017/05		 UI47292 The VSAM Capture Exit (IESVSCAP) fails to connect to an WebSphere MQ server with MQCCODE=0002 MQRCODE=085B when operating with MODE=MQCLIENT.
PI64081
2016/07		 UI38635 The VSAM Redirector handler "DBHander" does not allow to specify additional connection properties in the JDBC URL for the Microsoft SQl Server JDBC Driver. It only allows to specify one singe connection property, which must be the "DatabaseName" property. Any additional properties are incorrectly treated as separate options of the OPTION string.
Note: Above update affects the workstation code (Component 5686-CF9-38). Please download from here and reinstall the component on your workstation.
PI49037
2016/02		 UI31866 The new z/VSE SOAP support, that was introduced in z/VSE 5.2 and now supports literal encoding style, does not correctly handle complex copybooks with REDEFINES and OCCURS clauses. The result is that fields are mapped to a wrong location in the commarea. This affects z/VSE as SOAP server as well as z/VSE as SOAP client.
Required action: After applying this PTF you MUST also update the CICS2WS tool to version 2.7.0 (or later). You MUST then re-generate any existing RULES with the new CICS2WS tool version of 2.7.0 (or later), assemble them on z/VSE and perform a NEWCOPY on them in CICS. The z/VSE SOAP Engine will only accept RULES generated with a CICS2WS tool version of 2.7.0 (or later).
You should also apply the PTF for APAR PI49304. This PTF will ensure that the affected programs are properly defined in CICS. Alternatively you can define the programs using DFHCSDUP as described in the PTF cover letter. Note: Users of the 'old' SOAP support using generated PROXY code are not affected and do not need to update the CICS2WS version. However the new CICS2WS version will also work with the 'old' SOAP support.
PI51689
2015/11		 UI32654 When updating, deleting or inserting a VSAM record using the VSAM-via-CICS service fails (e.g. due to a duplicate key error) then that VSAM file may become unusable for subsequent requests. This may affect other CICS programs accessing the VSAM file. It may also hinder the file from being closed in CICS via CEMT SET FILE CLOSED.
PI49382
2015/10		 UI31613 The z/VSE SNMP Monitoring Agent returns incorrect CPU-time values when the system is running with CPU balancing active. Whenever the CPU balancing algorithm starts or stops CPUs the CPU-time value reported by the SNMP Monitoring Agent is incorrect.
PI42615
2015/07		 UI28409 Provide the new MQ Client Trigger Monitor function.
Notes:
  • Documentation for the MQ Client Trigger Monitor can be found here (PDF, 150KB)
  • After applying this PTF you must define program IESMQCTM and transaction MQTM to CICS. You also must add the MQTM transaction to the security manager (i.e. Basic Security Manager). Please use this job to do so.
  • After applying this PTF you may want to update the Online Message Explanation (OME) file with new messages issued by the MQ Client Trigger Monitor (prefix IESC6). Please use this job to update your OME file.
PI35643
2015/03
HIPER		 UI25399 When using z/VSE Fast Path to Linux on System z (LFP) to send huge amounts of data from remote to z/VSE, parts of the data may arrive on z/VSE in a wrong sequence. This can happen under rare circumstances, for example when the IUCV message limit is reached due to heavy workload.
Note: Above update affects the workstation code (Component 5686-CF9-38). Please download from here and update the LFPD on Linux (using rpm -u).
PI28790
2014/11		 UI22888 When a VSAM file is redirected, but the VSAM redirector is unable to connect to the redirector server (as indicated by message "IESC2003E FAILED TO CONNECT TO REDIRECTOR SERVER" on the console), or when the redirector handler reports an error during OPEN processing, then some control blocks are not freed, which can lead to a partition GETVIS leak. Note: On successful redirector operation no GETVIS is leaked.
PI26078
2014/10		 UI21730 The z/VSE HTTP Client (IESHTTPB/IESHTTPC) does not ASCII/EBCDIC-translate sent or received data with a content-type of "application/xml", although this content-type is textual.
PI22319
2014/08		 UI19748 The z/VSE SNMP Monitoring Agent truncates SNMP requests that are larger than 256 bytes. This results in a parsing error and causes the request to be ignored.
PI21772
2014/07		 UI19637 When a job is submitted via the Java-based Connectors, and the job abends/cancels, or does not set a return code, then the return code reported by Java methods VSEPowerEntry.getMaximumReturnCode() or VSEPowerEntry.getLastReturnCode() is an incorrect value, and there is no indication if the job has abended or just did not set a return code.
PI16803
2014/05		 UI17395 When re-executing an sql query through the z/VSE Database Connector (DBCLI) that previously returned an empty result, all subsequent results appear empty as well, even if the result would not be empty.
PI16766
2014/05		 UI17384 The Exception java.lang.ArrayIndexOutOfBoundsException occurs when using the VSAM Redirector loader with a filter specified and the data starts with the high-order bit on, e.g. FILTER-VALUE=X'900F'.
Note: Above update affects the workstation code (Component 5686-CF9-38). Please download from here and reinstall the component on your workstation.

Back to top

z/VSE Connectors 9.2 components

Comp. ID CLC Description
5686-CF9-35 52N VSE Connectors
5686-CF9-38 52P VSE Connector WS code

Back to top

Unsupported release: VSE Connectors 9.1 APARs for z/VSE V5.1

Last update: November 11, 2015

APAR
Date		 PTF Contents
PI51688
2015/11		 UI32653 When updating, deleting or inserting a VSAM record using the VSAM-via-CICS service fails (e.g. due to a duplicate key error) then that VSAM file may become unusable for subsequent requests. This may affect other CICS programs accessing the VSAM file. It may also hinder the file from being closed in CICS via CEMT SET FILE CLOSED.
PI49381
2015/10		 UI31612 The z/VSE SNMP Monitoring Agent returns incorrect CPU-time values when the system is running with CPU balancing active. Whenever the CPU balancing algorithm starts or stops CPUs the CPU-time value reported by the SNMP Monitoring Agent is incorrect.
PI42612
2015/07		 UI28408 Provide the new MQ Client Trigger Monitor function.
Notes:
  • Documentation for the MQ Client Trigger Monitor can be found here (PDF, 150KB)
  • After applying this PTF you must define program IESMQCTM and transaction MQTM to CICS. You also must add the MQTM transaction to the security manager (i.e. Basic Security Manager). Please use this job to do so.
  • After applying this PTF you may want to update the Online Message Explanation (OME) file with new messages issued by the MQ Client Trigger Monitor (prefix IESC6). Please use this job to update your OME file.
PI35642
2015/03
HIPER		 UI25398 When using z/VSE Fast Path to Linux on System z (LFP) to send huge amounts of data from remote to z/VSE, parts of the data may arrive on z/VSE in a wrong sequence. This can happen under rare circumstances, for example when the IUCV message limit is reached due to heavy workload.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and update the LFPD on Linux (using rpm -u).
PI28789
2014/11		 UI22887 When a VSAM file is redirected, but the VSAM redirector is unable to connect to the redirector server (as indicated by message "IESC2003E FAILED TO CONNECT TO REDIRECTOR SERVER" on the console), or when the redirector handler reports an error during OPEN processing, then some control blocks are not freed, which can lead to a partition GETVIS leak. Note: On successful redirector operation no GETVIS is leaked.
PI22545
2014/10		 UI21719
(LE PTF)		 Job submission (via VSEPower.executeJob() method) on z/VSE 5.1 may wait for the job to complete forever, although the job is already completed.
LE/C TIME() FUNCTION ALWAYS RETURNS THE SAME TIME VALUE
PI26077
2014/10		 UI21729 The z/VSE HTTP Client (IESHTTPB/IESHTTPC) does not ASCII/EBCDIC-translate sent or received data with a content-type of "application/xml", although this content-type is textual.
PI22318
2014/08		 UI19747 The z/VSE SNMP Monitoring Agent truncates SNMP requests that are larger than 256 bytes. This results in a parsing error and causes the request to be ignored.
PI21771
2014/07		 UI19636 When a job is submitted via the Java-based Connectors, and the job abends/cancels, or does not set a return code, then the return code reported by Java methods VSEPowerEntry.getMaximumReturnCode() or VSEPowerEntry.getLastReturnCode() is an incorrect value, and there is no indication if the job has abended or just did not set a return code.
PI16797
2014/05		 UI17394 When re-executing an sql query through the z/VSE Database Connector (DBCLI) that previously returned an empty result, all subsequent results appear empty as well, even if the result would not be empty.
PI13749
2014/03		 UI16040 The Exception java.lang.ArrayIndexOutOfBoundsException occurs when using the VSAM Redirector loader with a filter specified and the data starts with the high-order bit on, e.g. FILTER-VALUE=X'900F'.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PI09719
2014/01		 UI14278 The VSAM Redirector handler DBHandler may fail with an error Processing of request failed: com.ibm.vse.mapper.ProcessException: OccursCountField is not set when using a complex mapping that contains OCCURS DEPENDING ON clauses.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PI06549
2013/12		 UI12723 The VSE Connector Client cannot handle multiple DL/I PCBs having the same name in the PSB.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PI05110
2013/11		 UI11928 When using the z/VSE Database Connector (DBCLI) to call an Oracle stored procedure, the output parameters are not returned back to the VSE program. This is because the Oracle JDBC driver does not fully support the JDBC ParameterMetaData interface. The Oracle JDBC driver does not provide information about the parameters of an SQL statement. Because of that, DBCLI does not know if a parameter is IN, OUT or INOUT. In order to transfer the output parameters back to VSE, DBCLI needs to know which parameters are output parameters.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM97205
2013/10		 UK97651
  • The VSAM Redirector's MapperConfigGUI Tool treats all COMP-3 (packed decimal) fields as signed when importing a COBOL copybook, even when no sign is specified.
  • The following error may occur when using an OCCURS DEPENDING ON: Processing of request failed: com.ibm.vse.mapper.ProcessException: OccursCountField is not set.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM87426
2013/05		 UK93640
  • The VSE Connectors may return invalid MCC control characters when a POWER entry is retrieved including MCC printer control characters.
  • The VSAM JDBC Driver does not support SQL statements generated by the JDBC Wrapper of the IBM DB2/InfoSphere Federation Server.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM80540
2013/04		 UK91627 Support for Connection Pooling for the z/VSE Database Connector (DBCLI).
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM80539
2013/04		 UK91628 Support for Connection Pooling for the z/VSE Database Connector (DBCLI). Notes:
  • Manual "z/VSE V5R1 e-business Connectors, User's Guide" (SC34-2629-01) and "z/VSE V5R1 Messages and Codes, Volume 2" (SC34-2633-01) needs to be updated. Please see this PDF file (24KB) that contains the additions as well as descriptions for new messages.
  • You may use this job (4KB) to define new programs and transactions to CICS and Basic Security Manager.
  • This PTF also introduces a couple of new messages. You may want to run this binary job (17KB) to load the new messages into the online messages file (OME) to be able to use the EXPLAIN function on those new messages
PM78377
2012/12		 UK90057 The VSE Connector Server may go into a loop at user logon when a RACROUTE EXTRACT call fails. This may happen when using an external security manager (ESM) such as CA TopSecret, and the IUI segment is not available in the user record.
If you are using CA TopSecret then make sure that you have defined the user profile with the following fields from the IESIS segment: 
  IESFL1  = BAT,COD,VSAM
  IESFL2  = BQA,ESC,COU,CMD,OLPD,XRM
  IESINIT = IESEADM
  IESTYPE = USERTYPE1,NEW,SELECT
Note: The shown values are just examples and may be different in your system.
PM64676
2012/06		 UK78945
  • The VSE Connector Server has been corrected to perform proper resource security checks for LIBR and POWER resources.
  • The HTTP client has been corrected to handle calls from COBOL.
  • Support for alternate indexes when using VSAM-via-CICS service.
PM64799
2012/06		 UK78893 z/VSE Database Connector (DBCLI): INSERT statement without parameter markers fails to execute when using MS SQL Server JDBC Driver.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM64792
2012/06		 UK78892 Misc problems in z/VSE Database Connector (DBCLI):
  • SETPOS function with UPDATE operation corrupts the binding information.
  • INSERT statement without parameter markers fails to execute when using MS SQL Server JDBC Driver.
  • Added support for deferred input or output variables when using REXX.
PM56023
2012/06		 UK76218
  • New z/VSE Database Connector (DBCLI)
  • Added LPAR support for Fast Path to Linux on System z (LFP)
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM56020
2012/06		 UK76217 New z/VSE Database Connector (DBCLI)
PM58752
2012/03		 UK76534 The VSE Script Client fails to process the script return code when using code page CP1143.
PM58755
2012/03		 UK76459 The VSE Script Client fails to process the script return code when using code page CP1143.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM57359
2012/02		 UK75878
  1. The script function GETPOWERQUEUEENTRYASA returns invalid ASA control characters when a POWER entry is retrieved, that is stored using machine control characters (MCC).
  2. The HTML documentation for script function LISTPOWERQUEUE is incorrect. The USERFILTER and NAMEFILTER parameters are in reverse order.
  3. The VSE Script Server shows a ClassCastException in script function SAVEFILE for content that has been received from script function GETPOWERQUEUEENTRY.
Note: Above update is in the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM55958
2012/01		 UK75455 NO REC FND error or missing tape data when using the z/VSE VTAPE Server on z/VSE 5.1 GA level.
Note: Above update is in the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM53860
2011/12		 UK74736
(LE PTF)		 Abend of the z/VSE Connector Server on z/VSE 5.1 when accessing LIBR.
MSG CEE3322C AB4087 IN BATCH OR CICS ASSOCIATED BY MSG CEE2503S INDICATING OFFSET FROM UTC/GMT TO LOCAL TIME NOT AVAILABLE
PM53912
2011/12		 UK74585
  • The z/VSE SOAP Engine module IESSOAPS abends with 0C4/AKEA at offset X'FFFFFFFF' when the HTTP header field "Content-Type" does not contain a charset. 
  • Possible storage overlay caused by VSAM Capture Exit IESVSCAP due to DSA size mismatch.
PM51113
2011/11		 UK73638 SNMP Monitoring Agent: Discrepancies between the data sent by the agent and the MIB provided in IESMPMIB.Z may lead to data interpretation problems with SNMP clients.
PM50616
2011/11		 UK73369 Miscellaneous fixes for z/VSE 5.1 Connectors:
  • The SNMP trap client sends incorrect community string. 
  • GDPS Client does not send INIT command after STOPMAINTENANCE.

Back to top

z/VSE Connectors 9.1 components

Comp. ID CLC Description
5686-CF9-35 51N VSE Connectors
5686-CF9-38 51P VSE Connector WS code

Back to top

Unsupported release: VSE Connectors 8.3 APARs for z/VSE V4.3

Last update: October 14, 2014

APAR
Date		 PTF Contents
PI26076
2014/10		 UI21728 The z/VSE HTTP Client (IESHTTPB/IESHTTPC) does not ASCII/EBCDIC-translate sent or received data with a content-type of "application/xml", although this content-type is textual.
PI22317
2014/08		 UI19746 The z/VSE SNMP Monitoring Agent truncates SNMP requests that are larger than 256 bytes. This results in a parsing error and causes the request to be ignored.
PI21769
2014/07		 UI19635 When a job is submitted via the Java-based Connectors, and the job abends/cancels, or does not set a return code, then the return code reported by Java methods VSEPowerEntry.getMaximumReturnCode() or VSEPowerEntry.getLastReturnCode() is an incorrect value, and there is no indication if the job has abended or just did not set a return code.
PI13748
2014/03		 UI16039 The Exception java.lang.ArrayIndexOutOfBoundsException occurs when using the VSAM Redirector loader with a filter specified and the data starts with the high-order bit on, e.g. FILTER-VALUE=X'900F'.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PI09717
2014/01		 UI14277 The VSAM Redirector handler DBHandler may fail with an error Processing of request failed: com.ibm.vse.mapper.ProcessException: OccursCountField is not set when using a complex mapping that contains OCCURS DEPENDING ON clauses.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PI06546
2013/12		 UI12732 The VSE Connector Client cannot handle multiple DL/I PCBs having the same name in the PSB.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM97203
2013/10		 UK97650
  • The VSAM Redirector's MapperConfigGUI Tool treats all COMP-3 (packed decimal) fields as signed when importing a COBOL copybook, even when no sign is specified.
  • The following error may occur when using an OCCURS DEPENDING ON: Processing of request failed: com.ibm.vse.mapper.ProcessException: OccursCountField is not set.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM87424
2013/05		 UK93639
  • The VSE Connectors may return invalid MCC control characters when a POWER entry is retrieved including MCC printer control characters.
  • The VSAM JDBC Driver does not support SQL statements generated by the JDBC Wrapper of the IBM DB2/InfoSphere Federation Server.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM64675
2012/05		 UK78944
  • The VSE Connector Server has been corrected to perform proper resource security checks for LIBR and POWER resources.
  • The HTTP client has been corrected to handle calls from COBOL.
  • Support for alternate indexes when using VSAM-via-CICS service.
PM58735
2012/03		 UK76508
  1. The VSE Script Client fails to process the script return code when using code page CP1143.
  2. NOCONT parameter is not working.
PM58756
2012/03		 UK76460 The VSE Script Client fails to process the script return code when using code page CP1143. Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM57290
2012/02		 UK75877
  1. The script function GETPOWERQUEUEENTRYASA returns invalid ASA control characters when a POWER entry is retrieved, that is stored using machine control characters (MCC).
  2. The HTML documentation for script function LISTPOWERQUEUE is incorrect. The USERFILTER and NAMEFILTER parameters are in reverse order.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM53911
2011/12		 UK74575
  • The z/VSE SOAP Engine module IESSOAPS abends with 0C4/AKEA at offset X'FFFFFFFF' when the HTTP header field "Content-Type" does not contain a charset. 
  • Possible storage overlay caused by VSAM Capture Exit IESVSCAP due to DSA size mismatch.
PM51109
2011/11		 UK73637 SNMP Monitoring Agent: Discrepancies between the data sent by the agent and the MIB provided in IESMPMIB.Z may lead to data interpretation problems with SNMP clients.
PM41625
2011/06		 UK68779 The VSAM JDBC Driver method 'VsamJdbcStatement.getMoreResults' throws an exception 'Driver not capable'. This can happen when the VSAM JDBC Driver is used under WebSphere Application Server version 7.0.0.15 or later. The generic data store helper provided by WebSphere Application Server now seems to always call the getMoreResults method of the JDBC driver.
Note: Above update is in the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
 
PM33311
2011/03		 UK65406
  • SNMP Monitoring Agent may show TCP/IP error message "EDCV002I Unexpected TCP/IP error code: 157" on the z/VSE console.
  • Improper behavior of batch LDAP sign-on support.
PM25410
2010/11		 UK61692 The VSAM Capture Exit IESVSCAP allocates a huge amount of GETVIS below the line (GETVIS 24) over time. IESVSCAP needs about 2 times the maximum record length of the VSAM cluster that is captured per VSAM string. VSAM allows up to 256 strings per VSAM Cluster. The GETVIS usage can increase over time, as the applications make use of additional strings, and IESVSCAP allocates buffers for the newly used strings. These buffers are currently allocated below the line in partition GETVIS 24.
PM25055
2010/11		 UK61692 The SNMP Monitoring Agent does not work with Plug-ins supporting more than one group at the same OID level.
PM25056
2010/11		 UK61668 The password encryption feature of the delta loader does not work properly. When running the first time, the password is encrypted correctly, but any subsequent run fails because it does not find the encrypted password.
Note: Above update is in the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
 

 

Back to top

z/VSE Connectors 8.3 components

Comp. ID CLC Description
5686-CF8-35 02N VSE Connectors
5686-CF8-38 02P VSE Connector WS code

Back to top

Unsupported release: VSE Connector 8.2 APARs for z/VSE V4.2

Last update: May 30, 2012

APAR
Date		 PTF Contents
PM64674
2012/05		 UK78943
  • The VSE Connector Server has been corrected to perform proper resource security checks for LIBR and POWER resources.
  • The HTTP client has been corrected to handle calls from COBOL.
  • Support for alternate indexes when using VSAM-via-CICS service.
PM58783
2012/03		 UK76595
  1. The VSE Script Client fails to process the script return code when using code page CP1143.
  2. NOCONT parameter is not working.
PM58748
2012/03		 UK76430 The VSE Script Client fails to process the script return code when using code page CP1143.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM57475
2012/02		 UK75953
  1. The script function GETPOWERQUEUEENTRYASA returns invalid ASA control characters when a POWER entry is retrieved, that is stored using machine control characters (MCC).
  2. The HTML documentation for script function LISTPOWERQUEUE is incorrect. The USERFILTER and NAMEFILTER parameters are in reverse order.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PM53980
2011/12		 UK74691 The z/VSE SOAP Engine module IESSOAPS abends with 0C4/AKEA at offset X'FFFFFFFF' when the HTTP header field "Content-Type" does not contain a charset.
PM41618
2011/06		 UK68778 The VSAM JDBC Driver method 'VsamJdbcStatement.getMoreResults' throws an exception 'Driver not capable'. This can happen when the VSAM JDBC Driver is used under WebSphere Application Server version 7.0.0.15 or later. The generic data store helper provided by WebSphere Application Server now seems to always call the getMoreResults method of the JDBC driver.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
 
PM23301
2010/09		 UK60940 The VSAM Capture Exit IESVSCAP allocates a huge amount of GETVIS below the line (GETVIS 24) over time. IESVSCAP needs about 2 times the maximum record length of the VSAM cluster that is captured per VSAM string. VSAM allows up to 256 strings per VSAM Cluster. The GETVIS usage can increase over time, as the applications make use of additional strings, and IESVSCAP allocates buffers for the newly used strings. These buffers are currently allocated below the line in partition GETVIS 24.
PM20512
2010/08		 UK60097 Using remote VTAPE with ZLIB compressed tape records (ZAWS) may cause duplicate tape records to be written or various I/O errors due to AWSFormatError exceptions because of incorrect AWS control information being created under certain circumstances when writing ZLIB compressed tape records.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
Note: You must also install VSE/AF APAR DY46930 / PTF UD53369.
PM20790
2010/08		 UK59849 The VSAM Redirector Handlers DBHandler and DB2Handler do not support table names which contain a schema name like 'schema.table'. This leads to the following warning and error messages:
"WARNING: The database table 'schema.table' could not be scanned, no NULL support is given."
"ERROR: Map fields do not have a corresponding column in database table: <list of fields>"
Processing continues, but the handlers do not allow to set NULL as a value for the columns listed. This may cause subsequent errors during request processing.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
 
PM20764
2010/08		 UK59849 The ZONED converter does not correctly handle a positive sign (X'C') in signed ZONED fields (e.g. COBOL PIC S9(n)). This can cause an I/O error on a redirected VSAM cluster or an error when using the Redirector Loader. The log on the workstation shows an error like "ConverterZONED: Zone nibble of sign digit is invalid".
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
 
PM19632
2010/08		 UK59330 The VSAM Redirector handler "DBHandler" fails to process an ERASE request when the VSAM key position is not zero (at the beginning of the record). Most likely, the log shows a ProcessException with an ConverterException and message "Invalid byte array offset or length given". INSERT and UPDATE requests are not affected.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
 
PM09719
2010/03		 UK55085 When reading from a remote VTAPE using a zipped AWS file that contains tape records larger than 32K a NON COMPAT error may occur.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
Note: You must also install VSE/AF APAR DY46930 / PTF UD53369.
PM06028
2010/01		 UK53906 GETVIS leek when using VSAM Capture Exit IESVSCAP.
Not all allocated storage is freed during CLOSE processing when using the VSAM capture Exit IESVSCAP on a file that is opened for read only. This can lead to a no more GETVIS available situation when files are opened/closed frequently in the same program.
PM00522
2009/11		 UK51921 Receiving an empty VSE/POWER entry (an entry with 0 pages/lines) fails with a NotFoundException. This failure also causes subsequent requests for VSE/POWER resources to fail with a NotFoundException although these resources exist.
Note: An empty VSE/POWER entry can be created by a program that performs an OPEN on a printer device followed directly by a CLOSE, without writing any output. This will create an LST queue entry that just contains a control record, but no content.
Circumvention:
  • Use VSE/POWER option "SET LST0DAT=NO". With "SET LST0DAT=NO" such empty LST output is deleted.
  • Use Java method VSEPowerEntry.getNumberOfPagesSpooled() to check for zero pages and skip retrieval of the entry if it is empty.
PK98790
2009/10		 UK51152 The LDAP sign-on program IESLDSO holds an exclusive lock (GET for UPDATE) on the LDAP user-mapping file while it performs LDAP operations. This can hold of other sign-on attempts, even for non-LDAP users. In error situations, where the LDAP server cannot be reached, this can cause to hold the lock for several seconds, until the TCP/IP connect timeout has been reached.
PK93908
2009/08		 UK49299 An AccessDeniedException is thrown by the VSE Connector Client with the detail text "The key fields are not set" when using methods VSEVsamRecord.getNext() or getPrevious() although the key fields are set correctly.

Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
 
PK90430
2009/07		 UK48041 The skeleton SKSOAPOP in ICCF library 59 generates an incorrect phase name for the SOAP option phase. It generates IESLDCFG but should generate IESSOAPO. The incorrect phase name can cause the LDAP configuration phase to be overwritten.
Local Fix: Edit skeleton SKSOAPOP and change the phase name to IESSOAPO manually: 
 ...
 // OPTION ERRS,SXREF,SYM,NODECK,
                      CATAL,LISTX
    PHASE IESSOAPO,*,SVA
 // EXEC ASMA90,....
 ...
If the skeleton has already been submitted, please delete the IESLDCFG.PHASE from PRD2.CONFIG. If you are using LDAP sign-on support, you must re-generate the LDAP configuration using skeleton SKLDCFG.
PK87271
2009/05		 UK46978
  1. The LDAP User-Mapping Admin Tool IESLDUMA does not allow to generate passwords with special characters such as $, &, @ when using the GENPWD option with the PWDPATTERN keyword. An active SAF Router Exit (ICHRTX00) might require the password to contain special characters to comply corporate security policies.
  2. The LDAP password hash is not used when none of the LDAP servers can be reached. A longer hash expiration time should be used in such situations to allow the user's to sign on using the stored hash.
  3. Some LDAP servers are not case-sensitive with user IDs and password, but the LDAP user-mapping file stores case-sensitive LDAP user IDs. An option is missing to uppercase translate the LDAP user ID entered by the user.
Note: Updates for z/VSE V4.2 Administration Manual SC33-8304-02 Chapter 45 are contained in this PTF. Please see problem conclusion in the APAR text for details.
PK82623
2009/03		 UK44844 When using VSAM Redirector under CICS, you may receive the following VSAM CLOSE error when you terminate CICS using 'CEMT P SHUT I' and a redirected VSAM file is open at that time:
F8 0008 4228I FILE nnnnn CLOSE ERROR X'B8'(184) CAT=mmmm
(........) REQUEST ERROR: RPLFDBK = X'0C0004'
In this case VSAM will perform an autoclose at End of Task (EOT). VSAM Redirector cannot use TCP/IP services at EOT, thus it returns an error when closing the file.
PK76554
2008/12		 UK41883 1 MB data loss with remote Virtual Tapes in case of IDCAMS stacked BACKUP.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
Note: You must also install VSE/AF APAR DY46930 / PTF UD53369.
PK71658
2008/10		 UK40045 Pre GA problems in z/VSE 4.2.0:
  1. Unneeded trace messages appear from IESCVSRV (VSAM-via-CICS).
  2. When using VSAM Redirector with TCP/IP for VSE 1.5 F you may get the following message on a redirected GET request:
    IPN379I Socket Receive dropped from BG reason: Partition start address is inconsistent.
    The application that is executing the GET request hangs. Above situation happens if a GET is performed where the user buffer in RPL (addressed by RPLAREA, length in RPLRLEN) is shorter than the maximum record length of the cluster.
PK71659
2008/10		 UK40070 Pre GA problems in z/VSE 4.2.0:
  • VSE Connector Client:
    • When setting a field of a record for an ESDS type VSAM cluster, the method VSEVsamRecord.setField() throws the following exception: VSEVsamRecord.setField(): The key fields are not set. Use setKeyField first to specify the key. Since an ESDS type VSAM cluster does not have a primary key, it should not be required to specify the key fields.
    • BuildAppletZip does not work correctly
    • ssl.prop does not contain all cipher suites.
    • Keyring.pfx needs to be renewed.
  • VSE Script Server:
    • JavaDoc missing.
  • VSAM Redirector Server:
    • DATATIME Converter enhancements.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.

Back to top

VSE Connector 8.2 components

Comp. ID CLC Description
5686-CF8-35 01N VSE Connectors
5686-CF8-38 01P VSE Connector WS code

Back to top

Unsupported release: VSE Connector 8.1 APARs for z/VSE V4.1

Last update: September 30, 2010

APAR
Date		 PTF Contents
PM23281
2010/09		 UK60882 The VSAM Capture Exit IESVSCAP allocates a huge amount of GETVIS below the line (GETVIS 24) over time. IESVSCAP needs about 2 times the maximum record length of the VSAM cluster that is captured per VSAM string. VSAM allows up to 256 strings per VSAM Cluster. The GETVIS usage can increase over time, as the applications make use of additional strings, and IESVSCAP allocates buffers for the newly used strings. These buffers are currently allocated below the line in partition GETVIS 24.
PM20511
2010/08		 UK60096 Using remote VTAPE with ZLIB compressed tape records (ZAWS) may cause duplicate tape records to be written or various I/O errors due to AWSFormatError exceptions because of incorrect AWS control information being created under certain circumstances when writing ZLIB compressed tape records.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
Note: You must also install VSE/AF APAR DY46929 / PTF UD53368.
PM20855
2010/08		 UK59953 The VSAM Redirector Handlers DBHandler and DB2Handler do not support table names which contain a schema name like 'schema.table'. This leads to the following warning and error messages:
"WARNING: The database table 'schema.table' could not be scanned, no NULL support is given."
"ERROR: Map fields do not have a corresponding column in database table: <list of fields>"
Processing continues, but the handlers do not allow to set NULL as a value for the columns listed. This may cause subsequent errors during request processing.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
 
PM20849
2010/08		 UK59953 The ZONED converter does not correctly handle a positive sign (X'C') in signed ZONED fields (e.g. COBOL PIC S9(n) ). This can cause an I/O error on a redirected VSAM cluster or an error when using the Redirector Loader. The log on the workstation shows an error like "ConverterZONED: Zone nibble of sign digit is invalid".
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
 
PM19666
2010/08		 UK59370 The VSAM Redirector handler "DBHandler" fails to process an ERASE request when the VSAM key position is not zero (at the beginning of the record). Most likely, the log shows a ProcessException with an ConverterException and message "Invalid byte array offset or length given". INSERT and UPDATE requests are not affected.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
 
PM09766
2010/03		 UK55143 When reading from a remote VTAPE using a zipped AWS file that contains tape records larger than 32K a NON COMPAT error may occur.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
Note: You must also install VSE/AF APAR DY46929 / PTF UD53368.
PM06131
2010/01		 UK53929 GETVIS leek when using VSAM Capture Exit IESVSCAP.
Not all allocated storage is freed during CLOSE processing when using the VSAM capture Exit IESVSCAP on a file that is opened for read only. This can lead to a no more GETVIS available situation when files are opened/closed frequently in the same program.
PM00641
2009/11		 UK52008 Receiving an empty VSE/POWER entry (an entry with 0 pages/lines) fails with a NotFoundException. This failure also causes subsequent requests for VSE/POWER resources to fail with a NotFoundException although these resources exist.
Note: An empty VSE/POWER entry can be created by a program that performs an OPEN on a printer device followed directly by a CLOSE, without writing any output. This will create an LST queue entry that just contains a control record, but no content.
Circumvention:
  • Use VSE/POWER option "SET LST0DAT=NO". With "SET LST0DAT=NO" such empty LST output is deleted.
  • Use Java method VSEPowerEntry.getNumberOfPagesSpooled() to check for zero pages and skip retrieval of the entry if it is empty.
PK93907
2009/08		 UK49314 An AccessDeniedException is thrown by the VSE Connector Client with the detail text "The key fields are not set" when using methods VSEVsamRecord.getNext() or getPrevious() although the key fields are set correctly.

Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
 
PK82623
2009/03		 UK44849 When using VSAM Redirector under CICS, you may receive the following VSAM CLOSE error when you terminate CICS using 'CEMT P SHUT I' and a redirected VSAM file is open at that time:
F8 0008 4228I FILE nnnnn CLOSE ERROR X'B8'(184) CAT=mmmm
(........) REQUEST ERROR: RPLFDBK = X'0C0004'
In this case VSAM will perform an autoclose at End of Task (EOT). VSAM Redirector cannot use TCP/IP services at EOT, thus it returns an error when closing the file.
PK76553
2008/12		 UK41867 1 MB data loss with remote Virtual Tapes in case of IDCAMS stacked BACKUP.
Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
Note: You must also install VSE/AF APAR DY46929 / PTF UD53368.
PK73137
2008/10		 UK40483 When using the VSAM Redirector or Loader with the DBHandler, the following error messages are displayed.
Retrieve mapping configuration 'nnn' from table 'mmm'...
Error retrieving the mapping config.
com.ibm.vse.mapper.config. MapConfigException: Field type not set: yyyy
...
com.ibm.vse.redirector.VSAMRequestException: returnCode = 64

Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PK71251
2008/09		 UK39480 When trying to set a field of a record for an ESDS type VSAM cluster, the method VSEVsamRecord.setField() throws the following exception: "VSEVsamRecord.setField(): The key fields are not set. Use setKeyField() first to specify the key." Since an ESDS type VSAM cluster does not have a primary key, it should not be required to specify the key fields.

Note: Above update affects the workstation code (Component 5686-CF8-38). Please download from here and reinstall the component on your workstation.
PK69818
2008/08		 UK38508 When using VSAM Redirector together with TCP/IP for VSE 1.5F you may get the following message on a redirected GET request:
IPN379I Socket Receive dropped from BG reason: Partition start address is inconsistent.
The application that is executing the GET request hangs. Above situation happens if a GET is performed where the user buffer in RPL (addressed by RPLAREA, length in RPLRLEN) is shorter than the maximum record length of the cluster.
Please also apply TCP/IP for VSE FIX 124 (for 1.5F) or 146 for 1.5E.
PK69046
2008/07		 UK38174
  1. When using the VSE Connector client JDBC support, SQL INSERT or UPDATE requests may fail when the target columns in the SQL statement do not list the key fields at the beginning. The following exception is thrown: "com.ibm.vse.connector.AccessDeniedException: VSEVsamRecord.setField(): The key fields are not set. Use setKeyField() first to specify the key."
  2. When using the VSE Connector client to insert VSAM data, the insert may fail when a part of the VSAM key is mapped by two or more fields, but only one field is set. The following exception is thrown: "com.ibm.vse.connector.AccessDeniedException:
    VSEVsamRecord.setField(): The key fields are not set. Use setKeyField() first to specify the key."
Note: Above updates are in the workstation code (Component 5686-CF8-38). Please download from here and reinstall the components on your workstation.
PK67467
2008/07		 UK37307 A Java application using the VSE Connector Client receives a com.ibm.vse.connector.NotFoundException
for a VSAM Cluster, map or field although the resource is existent, if the VSE Connector Server runs at a high
load.
PK66537
2008/06		 UK36759 When using the VSEVsamCluster.selectRecords() method with a filter that builds a partial or complete key, the VSE Connector Server reads the whole VSAM file in case the VSAM file does not contain a record that matches the specified partial or complete key. This causes a long response time and high CPU and I/O utilization while the server reads through all records of the VSAM file.
PK63811
2008/04		 UK35523 ABEND 0C1/AKEA or 0C2/AKEA at X'FFFFFFFF' in program IESSOAPE when using VSE SOAP Support to call an external Web Service. Abend happens at iconv_close in IESSOAPC due to overlaid storage.

Note: You need to change the CSD definitions of programs IESSOAPC and IESSOAPE to EXECKey=CICS. Please see the DFHCSDUP.job
PK60658
2008/02		 UK33548
  1. Problems in VSE Script Server:
    • The logic for the 'IF' statement is not working correctly.
    • The line number reported in an script error ($SCRIPTERROR$) is incorrect.
    • Missing support for using SSL for connection to VSE.
  2. Installation problems with Java 6 and InstallShield: The error message "JVM not found" is displayed if installing under Java 6.
Note: Above updates are in the workstation code (Component 5686-CF8-38). Please download from here and reinstall the components on your workstation.
PK57267
2007/11		 UK31772 The VSE SOAP Engine fails to receive the response, in case the HTTP header specifies a charset enclosed in quotes: Content-Type: text/xml;charset="UTF-8". The code does not remove the quotes and tries to open a code page converter (iconv) with the code page name containing the quotes. The SOAP trace shows the following error situation:
IESSOAPC ASCII_CODEPAGE = "UTF-8"
IESSOAPC EBCDIC_CODEPAGE = IBM-1047
IESSOAPC INITCODEPAGES RC = 1
PK56772
2007/11		 UK31465
  1. When using VSE Connector Client or VSAM JDBC Driver in a pooled environment (e.g. within WebSphere Application Server) a connection error is not correctly handled. Instead, the calling application is receiving an exception: "Connection is currently used by another request."
  2. Misc corrections/updates in VSAM Redirector Server, including:
    • Support for DB2 on z/OS
    • Support for Informix
    • Support for MySQL
Note: Above updates are in the workstation code (Component 5686-CF8-38). Please download from here and reinstall the components on your workstation.
PK50743
2007/08		 UK28046 When adding a VSAM record with VSE Connectors through the VSAM-via-CICS service you may receive an AlreadyExistentException although the record has been inserted. This happens when the file is defined with RECORDFORMAT=F in CICS and the record mapping for that file does not map the complete record. This leads to a record being inserted that is shorter than required by CICS. CICS inserts the record, appends binary zeros to the record, but returns resp=LENGERR with resp2=14 (incorrect length for fixed length record format) which is incorrectly translated to an AlreadyExistentException.
PK43898
2007/04		 UK24399
  1. Under certain circumstances it can happen that VSAM-via-CICS mirror transaction ICVM keeps hanging. This may lead to MAXTASK situation in CICS. Also the client programs may not be able to access VSAM files via CICS in that situation.
  2. When using selectRecords() method with more than 1 filter, under certain circumstances only the first filter specification is used. All remaining filters are ignored. This can lead to incorrect or incomplete data to be returned.
PK38167
2007/03		 UK21783
  1. Abend in IESREDIR at VSAM CLOSE caused by zero AMBL pointer in ACB.
  2. 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.
  3. A LIBR rename operation fails with an internal error when the target name is the same as the current name.
  4. A LIBR copy operation fails to create the target member due to incorrect record format usage.
PK37967
2007/03		 UK21733 During startup of Security Server in FB partition the VSAM Redirector message IESC2001E FAILED TO LOAD CONFIG PHASE IESRDCFG occurs. Following this message the Security Server gets an VSAM OPEN error 4228I FILE BSTCNTL OPEN ERROR X'32'(050) CAT=VSESPUC and terminates.

Back to top

VSE Connector 8.1 components

Comp. ID CLC Description
5686-CF8-35 91N VSE Connectors
5686-CF8-38 91P VSE Connector WS code

Back to top

Unsupported release: VSE Connector 7.1 APARs for z/VSE V3.1

Last update March 18, 2009

APAR
Date		 PTF Contents
PK82701
2009/03		 UK44938 When using VSAM Redirector under CICS, you may receive the following VSAM CLOSE error when you terminate CICS using 'CEMT P SHUT I' and a redirected VSAM file is open at that time:
F8 0008 4228I FILE nnnnn CLOSE ERROR X'B8'(184) CAT=mmmm
(........) REQUEST ERROR: RPLFDBK = X'0C0004'
In this case VSAM will perform an autoclose at End of Task (EOT). VSAM Redirector cannot use TCP/IP services at EOT, thus it returns an error when closing the file.
PK75755
2008/12		 UK41622 1 MB data loss with remote Virtual Tapes in case of IDCAMS stacked BACKUP.
Note: Above update affects the workstation code (Component 5686-CF7-35). Please download from here and reinstall the component on your workstation.
Note: You must also install VSE/AF APAR DY46926 / PTF UD53361.
PK71241
2008/09		 UK39479 When trying to set a field of a record for an ESDS type VSAM cluster, the method VSEVsamRecord.setField() throws the following exception: "VSEVsamRecord.setField(): The key fields are not set. Use setKeyField() first to specify the key." Since an ESDS type VSAM cluster does not have a primary key, it should not be required to specify the key fields.

Note: Above update affects the workstation code (Component 5686-CF7-35). Please download from here and reinstall the component on your workstation.
PK69863
2008/08		 UK38648 When using VSAM Redirector together with TCP/IP for VSE 1.5F you may get the following message on a redirected GET request:
IPN379I Socket Receive dropped from BG reason: Partition start address is inconsistent.
The application that is executing the GET request hangs. Above situation happens if a GET is performed where the user buffer in RPL (addressed by RPLAREA, length in RPLRLEN) is shorter than the maximum record length of the cluster.
Please also apply TCP/IP for VSE FIX 124 (for 1.5F) or 146 for 1.5E.
PK69106
2008/07		 UK38208
  1. When using the VSE Connector client JDBC support, SQL INSERT or UPDATE requests may fail when the target columns in the SQL statement do not list the key fields at the beginning. The following exception is thrown: "com.ibm.vse.connector.AccessDeniedException: VSEVsamRecord.setField(): The key fields are not set. Use setKeyField() first to specify the key."
  2. When using the VSE Connector client to insert VSAM data, the insert may fail when a part of the VSAM key is mapped by two or more fields, but only one field is set. The following exception is thrown: "com.ibm.vse.connector.AccessDeniedException:
    VSEVsamRecord.setField(): The key fields are not set. Use setKeyField() first to specify the key."
Note: Above update affects the workstation code (Component 5686-CF7-35). Please download from here and reinstall the component on your workstation.
PK67494
2008/07		 UK37357 A Java application using the VSE Connector Client receives a com.ibm.vse.connector.NotFoundException for a VSAM Cluster, map or field although the resource is existent, if the VSE Connector Server runs at a high
load.
PK67191
2008/06		 UK37262 When using the VSE Connector Client method VSEVsamCluster.selectRecords() with a filter that builds a partial or complete key, the VSE Connector Server may fail to position to the specified key and instead positions to the beginning of the file. This may causes a long response time and high CPU and I/O utilization while the Server reads through all records of the VSAM file until it finds the record that matches the key.
PK66621
2008/06		 UK36822 When using the VSEVsamCluster.selectRecords() method with a filter that builds a partial or complete key, the VSE Connector Server reads the whole VSAM file in case the VSAM file does not contain a record that matches the specified partial or complete key. This causes a long response time and high CPU and I/O utilization while the server reads through all records of the VSAM file.
PK63805
2008/04		 UK35522 ABEND 0C1/AKEA or 0C2/AKEA at X'FFFFFFFF' in program IESSOAPE when using VSE SOAP Support to call an external Web Service. Abend happens at iconv_close in IESSOAPC due to overlaid storage.

Note: You need to change the CSD definitions of programs IESSOAPC and IESSOAPE to EXECKey=CICS. Please see the DFHCSDUP.job
PK60731
2008/02		 UK33625
  1. Problems in VSE Script Server:
    • The logic for the 'IF' statement is not working correctly.
    • The line number reported in an script error ($SCRIPTERROR$) is incorrect.
    • Missing support for using SSL for connection to VSE.
  2. Installation problems with Java 6 and InstallShield: The error message "JVM not found" is displayed if installing under Java 6.
Note: Above update affects the workstation code (Component 5686-CF7-35). Please download from here and reinstall the component on your workstation.
PK57314
2007/11		 UK31826 The VSE SOAP Engine fails to receive the response, in case the HTTP header specifies a charset enclosed in quotes: Content-Type: text/xml;charset="UTF-8". The code does not remove the quotes and tries to open a code page converter (iconv) with the code page name containing the quotes. The SOAP trace shows the following error situation:
IESSOAPC ASCII_CODEPAGE = "UTF-8"
IESSOAPC EBCDIC_CODEPAGE = IBM-1047
IESSOAPC INITCODEPAGES RC = 1
PK56828
2007/11		 UK31534 When using VSE Connector Client or VSAM JDBC Driver in a pooled environment (e.g. within WebSphere Application Server) a connection error is not correctly handled. Instead, the calling application is receiving an exception: "Connection is currently used by another request."

Note: Above update affects the workstation code (Component 5686-CF7-35). Please download from here and reinstall the component on your workstation.
PK50803
2007/08		 UK28104 When adding a VSAM record with VSE Connectors through the VSAM-via-CICS service you may receive an AlreadyExistentException although the record has been inserted. This happens when the file is defined with RECORDFORMAT=F in CICS and the record mapping for that file does not map the complete record. This leads to a record being inserted that is shorter than required by CICS. CICS inserts the record, appends binary zeros to the record, but returns resp=LENGERR with resp2=14 (incorrect length for fixed length record format) which is incorrectly translated to an AlreadyExistentException.
PK43803
2007/04		 UK24349
  1. Under certain circumstances it can happen that VSAM-via-CICS mirror transaction ICVM keeps hanging. This may lead to MAXTASK situation in CICS. Also the client programs may not be able to access VSAM files via CICS in that situation.
  2. When using selectRecords() method with more than 1 filter, under certain circumstances only the first filter specification is used. All remaining filters are ignored. This can lead to incorrect or incomplete data to be returned.
PK37259
2007/01		 UK21180 During startup of Security Server in FB partition the VSAM Redirector message IESC2001E FAILED TO LOAD CONFIG PHASE IESRDCFG occurs. Following this message the Security Server gets an VSAM OPEN error 4228I FILE BSTCNTL OPEN ERROR X'32'(050) CAT=VSESPUC and terminates.
 
PK35743
2006/12		 UK20385
  1. 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.
  2. 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.
PK32204
2006/10		 UK18624 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.
PK30197
2006/09		 UK17908 When opening a VSAM file with VSE Connector Server for read only (INPUT), the usage of data set name sharing causes the file being opened for write (OUTPUT) and therefore can cause sharing problems when the file is opened for OUTPUT in another partition and the VSAM share options do not allow to open the file twice for OUTPUT.
Note: You must also install LE/VSE PTF UK17703.
PK27028
2006/07		 UK15946
  1. 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".
  2. The XML Parser fails to parse tags with names that are only one character long (e.g. ). In this case error code NOT_WELL_FORMED (1) is returned.
PK25337
2006/05		 UK14888 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:
  1. Problems when using LOCATE mode with redirected VSAM cluster.
  2. Incorrect key position and length is used when accessing a redirected VSAM cluster via an alternate index.
  3. Problems when using VSAM Redirector with compressed clusters.
  4. Performance degradation with VSAM Redirector due to improper use of GETVIS/FREEVIS SVCs.
  5. VSE Connector Server partition runs out of GETVIS when using VisualAge Generator ITF access to many VSAM files due to use of data set name sharing with 255 strings.
PK18932
2006/02		 UK11718 Misc problems in VSE SOAP engine, XML parser and HTTP client:
  1. 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 PK20013 and PK19358).
  2. VSE XML parser has been enhanced to support XML entities. (Requirement MR0428053442).
  3. 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).
  4. HTTP client has been corrected to allow connections through a proxy server.
  5. HTTP client has been corrected to generate correct HTTP header 'accept-charset'.
  6. VSE SOAP interface has been enhanced to allow he use of longer method names (up to 128 chars). The interface is compatible with earlier versions, 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.
PK03240
2005/03		 UK01912 Several problems with VSE SOAP (Web Services) Support:
  1. 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.
  2. Progck in IESSOAPD due to invalid user TS-Queue entry: An incorrectly formatted 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 before the processing of that entry. In case an invalid entry is detected, an return code (INVALID_PARAM) is returned.
  3. Missing code page choice for SOAP/HTTP communication: Support for specifying ASCII and EBCDIC code pages has been added. The code pages can be specified in the SOAP option phase IESSOAPO (details see below).
  4. SOAP Methods without XML namespaces are considered as invalid: Usually the SOAP method is prefixed with an XML namespace . Some SOAP clients do not prefix the method: . Code has been changed to accept such requests using the default namespace.
  5. 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.
  6. 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.
  7. XML parser does not accept single quotation marks in attributes: XML attributes are usually enclosed in double quotation marks ("). Some XML documents use single quotation marks for attributes. The code has been changed to support both, double and single quotation marks.
  8. 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.

Back to top

VSE Connector 7.1 components

Comp. ID CLC Description
5686-CF7-35 81N VSE Connectors

Back to top

Unsupported release: VSE Connector 6.7 APARs for VSE/ESA V2.7

Last update December 15, 2006

APAR
Date		 PTF Contents
PK35852
2006/12		 UK20471
  1. 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.
  2. 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.
PK32398
2006/10		 UK18646 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.
PK27112
2006/07		 UK15982
  1. 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".
  2. The XML Parser fails to parse tags with names that are only one character long (e.g. ). In this case error code NOT_WELL_FORMED (1) is returned.
PK25404
2006/05		 UK14940 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:
  1. Problems when using LOCATE mode with redirected VSAM cluster.
  2. Incorrect key position and length is used when accessing a redirected VSAM cluster via an alternate index.
  3. Problems when using VSAM Redirector with compressed clusters.
  4. Performance degradation with VSAM Redirector due to improper use of GETVIS/FREEVIS SVCs.
  5. VSE Connector Server partition runs out of GETVIS when using VisualAge Generator ITF access to many VSAM files due to use of data set name sharing with 255 strings.
PK18960
2006/02		 UK11787 Misc problems in VSE SOAP engine, XML parser and HTTP client:
  1. 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).
  2. VSE XML parser has been enhanced to support XML entities. (Requirement MR0428053442).
  3. 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).
  4. HTTP client has been corrected to allow connections through a proxy server.
  5. HTTP client has been corrected to generate correct HTTP header 'accept-charset'.
  6. VSE SOAP interface has been enhanced to allow he use of longer method names (up to 128 chars). The interface is compatible with earlier versions, 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.
PK03036
2005/03		 UK01964 Several problems with VSE SOAP (Web Services) Support:
  1. 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.
  2. Progck in IESSOAPD due to invalid user TS-Queue entry: An incorrectly formatted 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 before the processing of that entry. In case an invalid entry is detected, an return code (INVALID_PARAM) is returned.
  3. Missing code page choice for SOAP/HTTP communication: Support for specifying ASCII and EBCDIC code pages has been added. The code pages can be specified in the SOAP option phase IESSOAPO (details see below).
  4. SOAP Methods without XML namespaces are considered as invalid: Usually the SOAP method is prefixed with an XML namespace . Some SOAP clients do not prefix the method: . Code has been changed to accept such requests using the default namespace.
  5. 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.
  6. 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.
  7. XML parser does not accept single quotation marks in attributes: XML attributes are usually enclosed in double quotation marks ("). Some XML documents use single quotation marks for attributes. The code has been changed to support both, double and single quotation marks.
  8. 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.
PQ97187
2004/11		 UQ95102 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 occurs. This is caused by duplicate fetchep() calls inside the parser.
PQ88809
2004/05		 UQ88865 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 code page is the default ASCII code page. 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 code page is specified.
  • SOAP: Misc corrections and recompile.
  • VSE Connector Client/JDBC: Misc corrections.
  • VSE Script Server: Misc corrections.
Note: Please download the newest VSE Connector Client, VSAM Redirector Server and VSE Script Server.
PQ83126
2004/01		 UQ84011 VSE Virtual Tape: Under some circumstances (tape record sizes) a BufferFullException is thrown which causes an IO error on VSE.

You should also install APAR DY46179.

Note: Please download the newest VSE Virtual Tape Server.
PQ74694
2003/06		 UQ77749
  • VSE Connectors: Misc fixes in client code.
  • 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 US 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 multiple 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 Redirector 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: minor 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:
    • CECI WRITEQ TS QUEUE(IESSOAPT) FROM('SCED0000')
    • CECI WRITEQ TS QUEUE(IESSOAPT) FROM('SCED0000') ITEM(1) REWRITE
  • VSE Virtual Tape: Misc fixes.
Note: Please download the newest VSE Connector Client, VSAM Redirector Server, VSE Script Server and VSE Virtual Tape Server.
PQ71095
2003/02		 UQ74256
  • VSE Connectors: A missing security check allows to access VSE Connector Server plug-ins to be executed although a previous logon was not successful or no logon was performed at all.
  • VisualAge Generator: The VSE Connector Server plug-in IESVSAPL now uses data set 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: minor fixes.
  • VSE SOAP and VSE Connector: recompile of C sources due to use of wrong compiler level.
Note: Please download the newest client code.

Back to top

VSE Connector 6.7 components

Comp. ID CLC Description
5686-066-35 75N VSE Connectors

Back to top

Unsupported release: VSE Connector 6.6 APARs for VSE/ESA V2.6

Last update February 15, 2006

APAR
Date		 PTF Contents
PK18960
2006/02		 UK11786 Misc problems in VSE SOAP engine, XML parser and HTTP client:
  1. 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).
  2. VSE XML parser has been enhanced to support XML entities. (Requirement MR0428053442).
  3. 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).
  4. HTTP client has been corrected to allow connections through a proxy server.
  5. HTTP client has been corrected to generate correct HTTP header 'accept-charset'.
  6. VSE SOAP interface has been enhanced to allow he use of longer method names (up to 128 chars). The interface is compatible with earlier versions, 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.
PK03036
2005/03		 UK01963 Several problems with VSE SOAP (Web Services) Support:
  1. 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.
  2. Progck in IESSOAPD due to invalid user TS-Queue entry: An incorrectly formatted 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 before the processing of that entry. In case an invalid entry is detected, an return code (INVALID_PARAM) is returned.
  3. Missing code page choice for SOAP/HTTP communication: Support for specifying ASCII and EBCDIC code pages has been added. The code pages can be specified in the SOAP option phase IESSOAPO (details see below).
  4. SOAP Methods without XML namespaces are considered as invalid: Usually the SOAP method is prefixed with an XML namespace . Some SOAP clients do not prefix the method: . Code has been changed to accept such requests using the default namespace.
  5. 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.
  6. 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.
  7. XML parser does not accept single quotation marks in attributes: XML attributes are usually enclosed in double quotation marks ("). Some XML documents use single quotation marks for attributes. The code has been changed to support both, double and single quotation marks.
  8. 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.
PQ97187
2004/11		 UQ95101 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 occurs. This is caused by duplicate fetchep() calls inside the parser.
PQ88809
2004/05		 UQ88864 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 code page is the default ASCII code page. 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 code page is specified.
  • SOAP: Misc corrections and recompile.
  • VSE Connector Client/JDBC: Misc corrections.
  • VSE Script Server: Misc corrections.
Note: Please download the newest VSE Connector Client, VSAM Redirector Server and VSE Script Server.
PQ83126
2004/01		 UQ84010 VSE Virtual Tape: Under some circumstances (tape record sizes) a BufferFullException is thrown which causes an IO error on VSE.

You should also install APAR DY46179.

Note: Please download the newest VSE Virtual Tape Server.
PQ78973
2003/10		 UQ81044 This PTF retrofits the SOAP functionality that has been introduced with VSE/ESA 2.7 to VSE/ESA 2.6.

Note: In order to use the SOAP functionality you must do the following steps:
  • Make sure you are on the required PTF Level for CICS/TS:
  • Define programs to CICS CSD: Run the DFHCSDUP job to define some CICS programs.
PQ74694
2003/06		 UQ77748
  • VSE Connectors: Misc fixes in client code.
  • 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 US 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 multiple 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 Redirector 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 allows to specify DD names (labels) for cluster and catalog. It also allows to specify a partition ID (e.g. F2) as filter.
  • VSE Virtual Tape: Misc fixes.
Note: Please download the newest VSE Connector Client, VSAM Redirector Server and VSE Virtual Tape Server.
PQ70859
2003/02		 UQ74414
  • VirtualTape: Accessing a remote virtual tape with tape records > 32K causes unexpected exceptions in the Virtual Tape Server.
  • VSEConnector: Accessing compressed VSAM clusters does not work correctly, due to invalid record length and key position information.
  • VSE Connector Client: misc. fixes for VSAM JDBC driver.
Note: Please download the newest VSE Connector Client and VSE Virtual Tape Server
PQ69928
2003/02		 UQ73820
  • A missing security check allows to access VSE Connector Server plug-ins 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.
  • Miscellaneous problems in VSAM JDBC driver.
PQ69300
2002/12		 UQ72624 For all VisualAge Generator users using VSAM remote access in ITF.
The VSE Connector Server plug-in IESVSAPL now uses data set name sharing to open a VSAM file. This allows to open a VSAM file more than once for update.
Note: This PTF requires LE APAR PQ69314.
PQ67459
2002/11		 UQ66736
  • VSEConnector: Error getting VSE System level from SPLEVEL.PROC.
  • VSEConnector: Performance problem in VSEVSAMCluster.selectRecords().
  • VSEConnector: Too small SEND/RECEIVE buffers for large records.
  • VSEConnector: Problems in DL/I Plug-in.
  • VSEConnector: Trap in ICCF request.
  • VSEConnector: Error in CopyMap function
  • VSEConnector: Added MaxRows Filter
  • VSEConnector: Error in JDBC Driver ResultSet skips rows with invalid data
  • VSAM Redirector: Use GETVIS LOC=BELOW in module IESREDCK
  • VSAM Redirector: Allow reconfiguration without restart of VSAM application.
  • VSAM Redirector: redesigned DB2 sample handler.
PQ60612
2002/06		 UQ71844
  • VSEConnectur: Specifying a partial key as filter in selectRecords did not locate to the first records identified by the partial key.
  • VSEConnectur: New keyword SECURITY in main config member to set the level of security:
    • FULL - Full security.
    • RESOURCE - Logon and resource, but no user type security.
    • LOGON - Only logon security, no resource and user type.
    • NO - no security, user can logon without a password.
    Default is SECURITY=FULL.
  • VSEConnectur: Skipping non existing libraries during LibraryList request.
  • VSAMRedirector: New module IESREDCK.OBJ.
PQ59275
2002/04		 UQ64865
  • VSAMRedirector: Problem with VSAM Redirector when processing a DELETE request and OWNER=REDIR.
  • VSAMRedirector: Specifying a different properties file did not work.
  • VSEConnectors: Minor updates in sample applets.
  • VSEConnectors: Specifying a different properties file did not work.
  • VirtualTape: Specifying a different properties file did not work
Included in VSE/ESA 2.6.1 refresh
PQ56517
2002/01		 UQ61889 Please see also PQ56557 (REXX)

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 result 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 (VSE Connector Server)
  • VSE IUI (EZA Socket Interface)
Included in VSE/ESA 2.6.1 refresh
PQ56024
2002/01		 UQ61889
  • VSEConnector: The VSE Connector Server crashes under some circumstances due to a internal storage overlay.
  • VSEConnector: Updating a VSAM record containing packed decimal fields may cause a ConcurrentUpdateException during VSEVsamRecord.commit().
  • VSAMRedirector: Minor problems with VSAM Redirector and Virtual Tape Server.
Included in VSE/ESA 2.6.1 refresh
PQ54703
2001/11		 UQ60250
  • VSE Connector: Problems in VSAM-via-CICS service for concurrent update checking.
  • VSAM Redirector: Problems in UPDREQONLY processing.
  • Virtual Tape Server: Problems in Workstation part of Virtual Tape Support
Included in VSE/ESA 2.6.1 refresh

Back to top

VSE Connector 6.6 components

Comp. ID CLC Description
5686-066-35 65N VSE Connectors

Back to top

Unsupported release: VSE Connector 6.5 APARs for VSE/ESA V2.5

Last update February 25, 2005

APAR
Date		 PTF Contents
PQ74694
2003/06		 UQ77747
  • 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 US 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.
PQ70859
2003/02		 UQ74413 VSEConnector: Accessing compressed VSAM clusters does not work correctly, due to invalid record length and key position information.
PQ69928
2003/02		 UQ73819 A missing security check allows to access VSE Connector Server plug-ins to be executed although a previous logon was not successful or no logon was performed at all.
PQ69300
2002/12		 UQ72623 For all VisualAge Generator users using VSAM remote access in ITF.
The VSE Connector Server plug-in IESVSAPL now uses data set name sharing to open a VSAM file. This allows to open a VSAM file more than once for update.
Note: This PTF requires LE APAR PQ69314.
PQ67458
2002/11		 UQ71832
  • Error getting VSE System level from SPLEVEL.PROC.
  • Performance problem in VSEVSAMCluster.selectRecords().
  • Too small SEND/RECEIVE buffers for large records.
  • Problems in DL/I Plug-in.
  • Trap in ICCF request.
PQ60611
2002/06		 UQ66733
  • Specifying a partial key as filter in selectRecords did not locate to the first records identified by the partial key.
  • New keyword SECURITY in main config member to set the level of security:
    • FULL - Full security.
    • RESOURCE - Logon and resource, but no user type security.
    • LOGON - Only logon security, no resource and user type.
    • NO - no security, user can logon without a password.
    Default is SECURITY=FULL.
  • Skipping non existing libraries during LibraryList request.
PQ56316
2002/01		 UQ62126
  • 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 Plug-in causes a internal dispatcher loop while gathering activity data. The Display Activity Plug-in seems to hang after first measurement interval.
PQ56023
2002/01		 UQ61521
  • The VSE Connector Server crashes under some circumstances due to a internal storage overlay.
  • Parallel access to the same VSAM data set causes NOT_FOUND error when using selectRecords() method.
PQ52261
2001/11		 UQ60340
  • The length of an PACKED field in a VSAM Map was calculated incorrectly.
  • Added support for PACKED fields up to 19 digits (10 bytes). Also added support for 64 bit integers (signed/unsigned).
  • Handling of VSAM open for empty cluster was wrong.
  • Logon of a user failed with TopSecret, because TopSecret does not allow to extract AF segment.
  • Update of a VSAM record did not write the updated data to disk immediately.
  • Read of a VSAM record holds a lock on the CI under some circumstances.
  • Update and Delete of a VSAM record did not check for concurrent updates.
Integrated into VSE/ESA 2.6
PQ51324
2001/08		 UQ56851
  • Filters at selectRecordsmethoddidnotworkwith<,<=,>,>= and STRING or BINARY data types.
  • Opening VSAM files for input did open with data set name sharing, which implies open for output.
  • Performance problem while handling a request due to calls to recv().
  • Performance problem at connect due to hostname lookup done by trace facility at client side.
  • Connection was not released to connection mananger in case of an exception during request handing.
  • Under some circumstances VSAM requests establishes a second connection during request processing.
  • The VSAM CLOSE ALL command did not close all opened files.
Integrated into VSE/ESA 2.6
PQ50122
2001/06		 UQ55480
  • When using method 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 record 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).
Integrated into VSE/ESA 2.6
PQ49063
2001/06		 UQ54777
  • 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 retrieving 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: ". Now displaying the line in error.
Integrated into VSE/ESA 2.6, included in VSE/ESA 2.5.2 refresh.
PQ41480
2000/09		 UQ46934 Several problems/enhancements in VSE Connector Server and VSE Connector Client.

Integrated into VSE/ESA 2.6, included in VSE/ESA 2.5.1 refresh.

Back to top

VSE Connector 6.5 components

Comp. ID CLC Description
5686-066-35 55N VSE Connectors

Back to top

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSB27H","label":"z\/VSE"},"Component":"--","Platform":[{"code":"PF038","label":"z\/VSE"}],"Version":"6.1","Edition":"","Line of Business":{"code":"LOB56","label":"Z HW"}}]

Document Information

Modified date:
09 October 2023

UID

isg3T1027427

Page Feedback