A fix is available
APAR status
Closed as program error.
Error description
Running a Rexx with PIPE CZR to retrieve messages from the Canzlog. The pipe does not find any messages for the filter, and fails with messages: DWO366E NUMERIC VALUE FFFFFFFF IS NOT VALID. IT IS NOT WITHIN THE RANGE REQUIRED BY THE COMMAND OR KEYWORD ON WHICH IT IS SPECIFIED. DWO362E PIPELINE TERMINATED. ERROR IN STAGE 1 IN PIPELINE 'PIPE': CZR TIME FFFFFFFF 50
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of Tivoli NetView for z/OS V6R2 * * and above (including IBM Automation Control * * for z/OS V1R1 and above) who use the CZR * * pipe stage. * **************************************************************** * PROBLEM DESCRIPTION: When a PIPE CZR is issued that results * * in no message found, the entire pipe * * fails, with the following messages: * * DWO366E NUMERIC VALUE xxxxxxxx IS NOT * * VALID. IT IS NOT WITHIN THE RANGE * * REQUIRED BY THE COMMAND OR KEYWORD ON * * WHICH IT IS SPECIFIED. * * DWO362E PIPELINE TERMINATED. ERROR IN * * STAGE n IN PIPELINE 'name': CZR TIME * * xxxxxxxx nn * * indicating that the TIME value is * * invalid, even though it may be * * perfectly fine. * * Also, the output from the LIST * * STATUS=CANZLOG command contains a x'00' * * between the date and time values. This * * prevents being able to parse the date * * and time by word. * **************************************************************** * RECOMMENDATION: * **************************************************************** During the init phase of the CZR pipe stage, module DSIPICZR calls module DSI4LAPN to find a CzID to be used as a starting point for retrieving matching messages. Module DSI4LAPN uses the passed filter (defined on a previous CNMECZFS command invocation) as criteria. If it finds no matches, it returns a non-zero return code to DSIPICZR. When DSIPICZR sees this return code, it issues msgDWO366E and terminates the pipe. This logic had been valid when it called module DSI4LAPM to find a starting point, since that doesn't use a filter. When the code was changed to call DSI4LAPN instead, getting a non-zero return code should not necessarily be considered a pipe error. Also, when module DSI4LCME is processing a LIST STATUS=CANZLOG command, it is initializing a string to hex zeroes, causing the character between the date and time to be x'00'.
Problem conclusion
Module DSI4LAPN is being changed to return a different return code to indicate that no messages were found because of the filter, as opposed to an invalid time frame used. Module DSIPICZR is being changed to recognize this new return code and to not fail the pipe when it's returned, but just to show no data. DSIPICZR is also being changed to default the FROM value to the current CZTOPDAT value, to give a valid starting point in case it's not specified. Modules DSI4LCMD and DSI4LSVC are being changed to also check for the new return code that can be returned from DSI4LAPN. Also, module DSI4LCME is being changed to initialize the string that will be returned for date and time for a LIST STATUS=CANZLOG to blanks instead of hexadecimal zeroes.
Temporary fix
Comments
APAR Information
APAR number
OA46788
Reported component name
AUTO CNTL NETV
Reported component ID
5698LSA01
Reported release
11B
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2014-12-17
Closed date
2015-05-15
Last modified date
2015-06-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA77403 UA77404
Modules/Macros
DSIPICZR DSI4LAPN DSI4LCMD DSI4LCME DSI4LSVC
Fix information
Fixed component name
AUTO CNTL NETV
Fixed component ID
5698LSA01
Applicable component levels
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":"11B","Edition":"","Line of Business":{"code":"","label":""}},{"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":"11B","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
09 August 2022