A fix is available
APAR status
Closed as program error.
Error description
When defining a BAS resource definition for TYPETERM, you have specified a value of 697 for the page size (PAGESIZE) and the default screen size (DEFSCREEN). This results in the following message being issued in CPSM: . EYUBN0005E applid CREATE failed for TYPETERM xxxx (version 1), RESP=16, RESP2LO=410, RESP2HI=10. . and the following messages in CICS: . DFHCA5224 E date time applid ???????? COIE Command not executed. The value of xxx is outside the valid range for DEFSCREEN. . DFHCA5224 E date time applid ???????? COIE Command not executed. The value of xxx is outside the valid range for PAGESIZE. . When defining this same resource to the CSD, it doesn't even allow you to specify a value outside the range of 0-255. However, the CPSM documentation when reviewing the TypeTerm definition, TYPTMDEF (WUI EYUSTARTTYPTMDEF.CREATE view) shows the valid range of values for DEFSCREEN and PAGESIZE as 0-999. So this leads one to believe a value of 697 for the would be valid. . Note: This issue can occur for the other values on the TYPETERM definition as well . . . Additional Symptom(s) Search Keyword(s): KIXREVGJT
Local fix
Set the value between 0-255
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V5R2M0, V5R3M0 * * and V5R4M0 Users * **************************************************************** * PROBLEM DESCRIPTION: TYPTMDEF objects created within CPSM * * Business Application Services (BAS) * * allow the definition of screen and * * page size parameters up to 999 * * characters. When such objects are * * installed, CICS rejects them because * * the maximum size for each row and * * column for both screen and page * * definitions is 255 characters. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes, MASes and WUI Servers must * * be recycled to pick up the new code. Note * * that these regions do not need to be brought * * down and restarted at the same time. * * * * When all regions have been restarted, the * * view set must be imported into the WUI * * server repository in order to pick up the * * changes. * * * * The view set can be imported via the * * AUTOIMPORTDSN and AUTOIMPORTMEM WUI server * * initialization parameters, or the IMPORT * * (from a dataset) function of the COVC WUI * * control transaction. * * * * If COVC is used to import the view set * * ensure that the TYPE operand is set to ALL * * or VIEWSET and that the Import option is set * * to OVERWRITE. * * * * For details on the AUTOIMPORTDSN and * * AUTOIMPORTMEM WUI server initialization * * parameters see "Web User Interface server * * initialization parameters" in the CICS * * Transaction Server for z/OS Version 5 * * Release 2 and Version 5 Release 3 Knowledge * * Centers, or in "Specifying Web User * * Interface server initialization parameters" * * in the CICS Transaction Server for z/OS * * Version 5 Release 4 Knowledge Center. * * * * For details on the COVC IMPORT function see * * "Importing WUI definitions using COVC" in * * the CICS Transaction Server for z/OS Version * * 5 Release 2, Version 5 Release 3 and Version * * 5 Release 4 Knowledge Centers. The updated * * starter set objects that need to be imported * * are named: * * * * EYUxA2YO * * * * Replace x with the required language version * * to be imported: * * * * E - English, K - Japanese, S - Chinese * * * * Ensure that the import references the * * SEYUVIEW dataset that was updated by the PTF * * that resolves this APAR. * * * * * * The TYPTMDEF (Typeterm definition) resource * * table includes eight attributes relating to * * the size of the screen or page associated * * with this object: * * * * - PAGESIZEROW * * - PAGESIZECOL * * - ALTPAGEROW * * - ALTPAGECOL * * - DEFSCREENROW * * - DEFSCREENCOL * * - ALTSCREENROW * * - ALTSCREENCOL * * * * For each of these attributes the current * * field level help states that the allowable * * value range is 0-999. This is an incorrect * * range value, which this APAR now corrects to * * "0-255". * * * * It is possible that some users may have * * already defined TYPTMDEFs with over-sized * * field values for the attributes associated * * with this APAR. Any attempt to install these * * TYPTMDEFs will result in a rejection by * * CICS. To correct this, users are recommended * * to update the affected TYPTMDEFs (via the * * CPSM WUI, CICS Explorer, or whatever * * mechanism of their choosing). This will * * cause validation processing to highlight the * * fields that are erroneously defined, and * * enable users to correct their values. * **************************************************************** TYPTMDEF objects created within CPSM Business Application Services (BAS) allow the definition of screen and page size parameters up to 999 characters long. When the objects are installed, CICS rejects them because the maximum size for each row and column (for both screen and page definitions) is 255 characters. The TYPTMDEF attributes affected are: - PAGESIZEROW - PAGESIZECOL - ALTPAGEROW - ALTPAGECOL - DEFSCREENROW - DEFSCREENCOL - ALTSCREENROW - ALTSCREENCOL The upper bound valid range value for these attributes has been reduced to 255 (from 999) in the TYPTMDEF resource table.
Problem conclusion
The allowable maximum value for the affected attributes has been shortened to 255 in the TYPTMDEF resource table definition. The field level help has been modified to state the allowable maximum size, and the allowable value range on the EYUSTARTTYPTMDEF CREATE and UPDATE views has been changed to "0-255".
Temporary fix
Comments
APAR Information
APAR number
PI86253
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
90M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-08-22
Closed date
2017-10-03
Last modified date
2017-11-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI50816 UI50817 UI50818
Modules/Macros
EYUE3816 EYUEA2Y0 EYUK3816 EYUKA2Y0 EYUS3816 EYUSA2Y0 EYUT3816 EYUY3816
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
R00M PSY UI50817
UP17/10/07 P F710
R10M PSY UI50818
UP17/10/07 P F710
R90M PSY UI50816
UP17/10/07 P F710
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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"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":"5.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 November 2017