A fix is available
APAR status
Closed as program error.
Error description
Data Streamer does not support masking of started tasks in the policy file when defining z Log Forwarder streams, where job names contain a wildcard.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All Common Data Provider for z Systems * * V1.1.0 users. * **************************************************************** * PROBLEM DESCRIPTION: 1. The Data Streamer does not support * * wildcards in the zLF Job Name * * parameter to mask started * * tasks/jobnames. * * * * 2. When TCP/IP is not available, * * excessive input/output exception * * messages are generated by the Data * * Streamer. * **************************************************************** * RECOMMENDATION: * **************************************************************** 1. The Data Streamer rejected data from zLF streams defined with the Job Name parameter containing wildcards. 2. The Data Streamer did not handle socket exceptions caused by loss of TCP/IP correctly.
Problem conclusion
1. The Data Streamer now supports zLF streams defined with the Job Name parameter containing wildcards. 2. The Data Streamer now manages socket exceptions without generating excessive error messages. NOTE: Please review ++HOLDACT as follows: COMMENT (************************************************************** * FUNCTION AFFECTED: IBM Common Data Provider for z Systems * * - Common Data Handler * ************************************************************** * DESCRIPTION : Installation notes * ************************************************************** * TIMING : POST-APPLY * ************************************************************** * * * When using the CDP Configuration Tool to add any Data * * Streams from the Generic Feeds category, the following * * restrictions apply: * * * * 1. Data Source Name * * The length of the value must be less than or equal * * to 12 characters. * * If using the default value of JOB001-DDNAME, it must * * be changed to JOB001-DDNAM. * * * * 2. Job Name * * Wildcards are now supported and the length of the value * * must be less than or equal to 8 characters. * * * * After you have saved the policy with the above changes, * * you need to do the following: * * * * a. Copy the file with extension of .logf.properties to the * * zLF ENVDIR directory and rename it to config.properties * * * * b. Verify that the config.properties file contain the * * modified values for the Data Source Name and Job Name. * * * * c. Stop and re-start the zLF and Data Streamer. * * * **************************************************************) Documentation changes as follows: Administration Guide and Reference SC22-5474-00 Product documentation is updated as follows: +---- IBM Common Data Provider for z Systems V1.1.0 ----+ | | |PROGRAM NUMBER: 5698-ABJ | | | |TITLE: IBM Common Data Provider for z Systems User's | | Guide | +-------------------------------------------------------------+ | | |Chapter: Troubleshooting, messages, and support | | | |Section: "Data Streamer messages" | | | |Add the following 3 new messages: | | | |HBO6091E Data Streamer could not open connection to | | input socket. Retrying current_attempt of | | max_attempts attempts in n seconds. | | | |Explanation: Data Streamer is unable to open the input | | socket which gatherers connect to. | | current_attempt: current attempt count | | max_attempts: how many times Data Streamer will | | attempt to reopen connection to the input | | socket. | | | | n: how many seconds until the next | | attempt. | | | |System action: Data Streamer will attempt to reopen the | | connection to the input socket in the | | specified by max_attempts at the specified | | seconds interval. | | | |User response: This error is caused by TCPIP not being | | available on the system where Data Streamer | | is running. Ensure that TCPIP is running on | | the system. Once TCPIP is running, Data | | Streamer will be able to reopen the | | connection. | | | |HBO6097E Unexpected error while Data Streamer attempted to | | open connection to input socket. Data Streamer is | | shutting down. | | | |Explanation: An unexpected error occurred while | | attempting to open connection to the input | | socket which gatherers connect to. | | | |System action: Data Streamer will shut down. | | | |User response: This error can be caused by TCPIP not | | being available on the system where | | Data Streamer is running. Ensure TCPIP is | | running on the system before restarting | | Data Streamer. | | | | | |HBO6098E TCPIP not available. Data Streamer closing socket | | before attempting reconnection to input socket. | | Attempting reconnection in n minutes. | | | |Explanation: TCPIP is not available and Data Streamer | | is attempting to reopen connection to the input | | socket which gatherers connect to. | | | | n : how many minutes until the next | | reconnection attempt. | | | |System action: While TCPIP is not available, Data Streamer | | will continue to reopen the connection to the | | input socket at the interval specified | | by n minutes. | | | |User response: Ensure TCPIP is running on the system. | | Once available, Data Streamer will be able to | | reopen the connection to the input socket. | | | +-------------------------------------------------------------+
Temporary fix
Comments
APAR Information
APAR number
OA52071
Reported component name
COMMON DATA HAN
Reported component ID
5698ABJ02
Reported release
110
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-02-06
Closed date
2017-03-08
Last modified date
2017-04-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA91289
Modules/Macros
HBOCDEDS
SC27462401 |
Fix information
Fixed component name
COMMON DATA HAN
Fixed component ID
5698ABJ02
Applicable component levels
R110 PSY UA91289
UP17/03/09 P F703
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"110","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 April 2017