IBM Support

OA47872: SUPPORT LONGER GLOBAL VARIABLE NAMES AND VALUES (BASE PORTION)

A fix is available

Subscribe

You can track all active APARs for this component.

 

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
    

Publications Referenced
SC27284603SC27284706SC27284805GI11944306GC27285606
GC27285706SC27285802SC27285905SC27287403SC27286002

Fix information

  • Fixed component name

    AUTO CNTL NETV

  • Fixed component ID

    5698LSA01

Applicable component levels

  • R12B PSY UA78359

       UP15/09/05 P F509

  • R12E PSY UA78360

       UP15/09/05 P F509

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