A fix is available
APAR status
Closed as new function.
Error description
Currently, global variables have a limit of 31 characters and global variables values have a limit of 255 characters. This length limit should be increased.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of Tivoli NetView for z/OS or IBM * * Automation Control for z/OS. * **************************************************************** * PROBLEM DESCRIPTION: Global variable (both common and task) * * names and values are limited to 31 and * * 255, respectively. This is too much of * * a limitation for some users. * **************************************************************** * RECOMMENDATION: * **************************************************************** Users of the NetView product, including the System Automation for z/OS product, have requested that the length limitations for global variable names and values be increased to provide more flexibility. The following are the current limits: Global variable names: up to 31 Global variable values: up to 255
Problem conclusion
Temporary fix
Comments
NetView code is being enhanced to allow all external interfaces (with certain exceptions) to set and retrieve common and task global variables and values with much higher limitations, as follows: Global variable names: up to 250 Global variable values: up to 31000 As such, the following command and macro interfaces now support the full extent of the larger sizes as listed above: - CGLOBAL/TGLOBAL commands - GLOBALV DEFC/DEFT/GETC/GETT/PUTC/PUTT/PURGEC/PURGET commands - VAR/$VAR/STEM/$STEM pipe stages - VARLOAD pipe stage - GLOBALV AUTOC/AUTOT commands - GLOBALV TRACEC/TRACET commands - QRYGLOBL command - DSIVARS macro - CNMVARS/CNMVARPOOL callable service - CNMIPCS dump formatting tool The following items have length restrictions which allow for shorter sizes than those listed above, which are explained in the accompanying documentation: - CGED command - SETCGLOB command - DSICGLOB/DSITGLOB automation table functions (ATF) - GLOBALV SAVEC/SAVET/RESTOREC/RESTORET commands - Messages DWO990I, DWO991I, DWO992I and DWO994I Longer global variables names and values can be saved in the DSISVRT save/restore database, as long as the database is reallocated with a larger record size. (New sample CNMSJM15 is being shipped to simplify this migration.) However, there is a limit of 4000 characters for the total of the lengths of the global variable name and value to be saved in the save/restore database. New sample programs CNMS8053 and CNMS8054 are being shipped to provide an alternate means of saving and restoring global variable names and their values that exceed this limit. See NetView APAR OA47874 and SA for z/OS APAR OA48160 for additional changes associated with this enhancement. Also, the following summarizes the documentation changes that should be made for this enhancement: - The length limitation should be increased for the varname in DSICGLOB and DSITGLOB ATFs in the Tivoli NetView for z/OS V6R2M1 Automation Guide (SC27-2846-03). - The description of the user_entered_variable operand should be changed and three Usage Notes should be added to the description of the CGED command in the Tivoli NetView for z/OS V6R2M1 Command Reference Volume 1 (A-N) (SC27-2847-06). - The Tivoli NetView for z/OS V6R2M1 Command Reference Volume 2 (O-Z) (SC27-2848-05) should have the following changes: - Length limits should be changed for the GETMLINE, GETMPRES, GETMSIZE, GETMTFLG, GETMTYPE and PARSEL2R commands. - Length limits should be changed for all flavors of the GLOBALV command. - Two restrictions should be added to the GLOBALV SAVE command. - The QRYGLOBL command should have the following updates: - The new LONGVAR operand should be added to the syntax diagram and described. - The restriction about DSILIST should be changed. - The example about avoiding data trunctions should be updated. - The length limitation of 255 should be documented under the SETCGLOB command. - The syntax diagram for the UPDCGLOB (NCCF) command should be corrected. - The description of message BNH039I should be updated and the descriptions for new messages BNH917I and BNH918I should be added to the Tivoli NetView for z/OS V6R2M1 Messages and Codes Volume 1 (AAU-DSI) manual (GC27-2856-06). - The length limitation of 255 should be documented under description of messages DWO990I, DWO991I, DWO992I and DWO994I in the Tivoli NetView for z/OS V6R2M1 Messages and Codes Volume 2 (DUI-IHS) manual (GC27-2857-06). - The descriptions of the STEM, $STEM, VAR, $VAR and VARLOAD stages should be updated to reflect the new length limitations in the Tivoli NetView for z/OS V6R2M1 Programming: Pipes manual (SC27-2859-05), as well as a new Usage Note added to describe length limitations. - The description of the DSIVARS macro should be updated to reflect the new length limitations in the Tivoli NetView for z/OS V6R2M1 Programming: Assembler manual (SC27-2858-02). - The description of the CNMVARS/CNMVARPOOL callable services should be updated to reflect the new length limitations in the Tivoli NetView for z/OS V6R2M1 Programming: PL/I and C manual (SC27-2860-02). - The Tivoli NetView for z/OS V6R2M1 Tuning Guide (SC27-2874-03) should be updated to document possible performance and limitation concerns related to this enhancement. - New samples CNMS8053, CNMS8054 and CNMSJM15 should be added to the list of samples in the Tivoli NetView for z/OS V6R2M1 Installation: Getting Started manual (GI11-9443-06). See member CNMREAD1 that is shipped with this APAR (which will be installed into the CNMSAMP target library when the PTF is applied) for details of the documentation changes. The online help for respective commands is being changed to reflect the documentation changes mentioned above. Also, be aware that there are no Japanese language changes being shipped with this APAR. These will be forthcoming in a future APAR.
APAR Information
APAR number
OA47872
Reported component name
AUTO CNTL NETV
Reported component ID
5698LSA01
Reported release
12B
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function
Submitted date
2015-05-14
Closed date
2015-07-29
Last modified date
2015-10-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
OA47874 UA78359 UA78360
Modules/Macros
AAUAHKPA AAUDRSRD AAUDRSRO AAUDRSSV AAUICPEX BNH03 BNH91 CNME1080 CNME1081 CNMHELPF CNMIPCS CNMIPTVB CNMREAD1 CNMSJM15 CNMS8053 CNMS8054 DSIAMCGL DSIAMTGL DSICDBLD DSICDFQ DSICDM DSICDMPV DSICDVAR DSIGLVAR DSIGVINT DSIGVP DSIMDMH DSIMREST DSIPISTM DSIPIVAR DSIQGLOB DSIRXFTC DSISYMCK DSIVARM DWO99 EUYAOBAS EUYCLIST EUYNONO2 EUYNONO3 EUYNONO4 EUYPISTM EUYPIVAR EUYQROBL EUYSELOB EUYSLIST EUYUPLOB EUYVRST EZLEVLST EZLE8400 EZLE8410
SC27284603 | SC27284706 | SC27284805 | GI11944306 | GC27285606 |
GC27285706 | SC27285802 | SC27285905 | SC27287403 | SC27286002 |
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":"12B","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":"12B","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
09 August 2022