IBM Support

OA41749: SMALL ENHANCEMENTS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • Small Enhancements
    .
    When running with z/OS V2R1, the INGSTR command results in the
    following error:
    AOF200I COMMAND INGRVX9Q FAILED. RECEIVED RETURN CODE 12014
            FROM HSAPRIXC IXLMG ERROR. RC=8 RSN=080E
    AOF206I : "INGRVX9Q" COMMAND FAILED FOR INGRVX9A :
            RECEIVED "RC = 3"
    ****************************************************************
    Added symptom: Non-printable characters will cause session
    manager errors in SDF and message AOFS020I 'Too many columns
    defined for screen width' is issued.
    ****************************************************************
    Added symptom: IHVD999E I/O-OPS Abend 0C4, CSECT=IHVDBRS
    ABEND0C4 ABENDS0C4
    See technote with same symptoms for JCL to run IHVBCHD
    ****************************************************************
    ZOS0201T/K
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All SA z/OS V3R3 and V3R4 customers.         *
    ****************************************************************
    * PROBLEM DESCRIPTION: see description below...                *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    SA 3.3, 3.4:
    o Blanks need to be stripped off from the Cmd field on the
    INGMOVE panel in order to avoid incomplete error messages.
    o Make sure the password is protected/hidden for INGOMX command.
    o When more than 5000 MTRs with the same message are defined
    in a PDB then there is a variable overflow when the 'Message
    Automation Overview' panel is invoked:
    ISPF ERROR OCCURRED AT: EXEC=AOFFVTDC CALLID=Accsng16
    FUNCTION=VPUT RC=20.
    o The ACF REQ=REPL command should not change data to upper case
    when called with NETVASIS.
    o Enhance INGEREXC to REXX Compile IHV* parts.
    o Convert none-printable characters to avoid session manager
    errors in SDF.
    o Add QUAL=* to INGLKUP help.
    o Enhance INGCF and INGSTR for situations where a structure's
    initial size is less than than its actual size. Refer to the
    DOC changes for more information.
    
    SA 3.4:
    o Remove some obsolete text from help panel AOFHENAM.
    o 'Automation Environment' display on TEP is wrong due to
    incorrect parsing of the INGAMS output in TEP command
    Processor INGRAHCP.
    o Introduce AAO AOF_AAO_AOCUPDT_LOGGING. This allows to
    override the LOG parameter of the AOCUPDT command. Refer to
    the DOC changes for more information.
    o Enhancements in add-on policy *SAP.
    o Enhance/correct help for INGCFG command and ING001I message.
    o Enhance Detail Status Display in SDF to make sure that
    date/time is updated when a key is pressed.
    o Enhance/correct DISPSTAT filter behavior when, for example,
    returning from the SETSTATE panel and then press PF5=Filters.
    DISPSTAT display should not have the filter active for the
    status of the resource from previous SETSTATE panel.
    

Problem conclusion

  • KEYWORDS: ZOS0201T/K ZOS0202T/K
    

Temporary fix

Comments

  • Changes have been made to implement the enhancements listed
    above.
    
    +------ System Automation for z/OS Version 3 Release 3 --------+
    |                                                              |
    |PROGRAM NUMBER: 5698-SA3                                      |
    |                                                              |
    |TITLE:       System Automation for z/OS         SC34-2575-02  |
    |             Operator's Commands                              |
    |                                                              |
    |CHAPTER:    2.0 SA z/OS System Operations Commands            |
    |SECTION:    2.1 System Operations Commands                    |
    |SUBSECTION: 2.1.51 INGLKUP                                    |
    |TOPIC:      Syntax                                            |
    |                                                              |
    |CHANGE:                                                       |
    | Replace the QUAL part of the syntax diagram with:            |
    |                                                              |
    |    .-QUAL=ALL------------.                                   |
    |  --.---------------------.--.-------------.--                |
    |    |        <--------<   |  '-TIMEOUT=nnn-'                  |
    |    '-QUAL=(--.- * --.--)-'                                   |
    |              |-APPC-|                                        |
    |              |-JOB--|                                        |
    |              '-STC--'                                        |
    |                                                              |
    |TOPIC:      Parameters                                        |
    |                                                              |
    |CHANGE:                                                       |
    |                                                              |
    | Replace the QUAL parameter description with:                 |
    |                                                              |
    |  QUAL                                                        |
    |      Specifies the type of "job" to be displayed. QUAL can   |
    |      be ALL, JOB, STC, APPC or '*'. The default is ALL. You  |
    |      can specify more than one qualifier by enclosing the    |
    |      qualifiers in parentheses.                              |
    |                                                              |
    |  TIMEOUT                                                     |
    |      Specifies the maximum number of seconds the INGLKUP     |
    |      command waits for responses from the remote system the  |
    |      command was sent to. The maximum is 999 seconds. The    |
    |      default is 30 seconds.                                  |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 3 --------+
    |                                                              |
    |PROGRAM NUMBER: 5698-SA3                                      |
    |                                                              |
    |TITLE:  System Automation for zOS                             |
    |        Operator's Commands                      SC34-2575-02 |
    |                                                              |
    |CHAPTER:    2.0         SA z/OS System Operations Commands and|
    |                        Routines                              |
    |TOPIC:      2.1         SA z/OS System Operations Commands    |
    |SUBTOPIC:   2.1.1       Using System Operations Commands      |
    |HEADING:    2.1.33      INGCF                                 |
    |SUBHEADING: 2.1.33.7    Structure Conditions                  |
    |                                                              |
    |CHANGE:                                                       |
    | Replace the text under 'The structure's initial size is less |
    | than its actual size' with the following:                    |
    |                                                              |
    | The SIZE value is greater twice the INITSIZE value.          |
    | The structure can be rebuilt, but a SIZE value that is       |
    | greater than twice the INITSIZE might cause the following:   |
    |                                                              |
    | o  It might be impossible to allocate a structure at a size  |
    |    of INITSIZE, because the amount of control storage that is|
    |    required to  support the SIZE value might actually be     |
    |    larger than INIT SIZE.                                    |
    |                                                              |
    | o  If the allocation succeeds, it might result in a structure|
    |    with a proportionally large amount of its storage allotted|
    |    to structure controls, leaving too few structure objects  |
    |    to be exploited usefully by the associated application.   |
    |                                                              |
    | For example, if you have requested a maximum size that is    |
    | very much larger than the initial size, the system will      |
    | attempt to use a proportionally large amount of the allocated|
    | storage for its controls. The result could be that the       |
    | allocated storage contains control structures for the future |
    | maximum size of the structure and insufficient storage might |
    | remain for the application's initial use.                    |
    |--------------------------------------------------------------|
    |HEADING:    2.1.72      INGSTR                                |
    |                                                              |
    |CHANGE:                                                       |
    | Under subtopic 'Structure Conditions', replace the text under|
    | 'The structure's initial size is less than than its actual   |
    | size' with  the following:                                   |
    |                                                              |
    | The SIZE value is greater twice the INITSIZE value.          |
    | The structure can be rebuilt, but a SIZE value that is       |
    | greater than twice the INITSIZE might cause the following:   |
    |                                                              |
    | o  It might be impossible to allocate a structure at a size  |
    |    of INITSIZE, because the amount of control storage that is|
    |    required to  support the SIZE value might actually be     |
    |    larger than INIT SIZE.                                    |
    |                                                              |
    | o  If the allocation succeeds, it might result in a structure|
    |    with a proportionally large amount of its storage allotted|
    |    to structure controls, leaving too few structure objects  |
    |    to be exploited usefully by the associated application.   |
    |                                                              |
    | For example, if you have requested a maximum size that is    |
    | very much larger than the initial size, the system will      |
    | attempt to use a proportionally large amount of the allocated|
    | storage for its controls. The result could be that the       |
    | allocated storage contains control structures for the future |
    | maximum size of the structure and insufficient storage might |
    | remain for the application's initial use.                    |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 4 --------+
    |                                                              |
    |PROGRAM NUMBER: 5698-SA3                                      |
    |                                                              |
    |TITLE:       System Automation for z/OS         SC34-2649-00  |
    |             Operator's Commands                              |
    |                                                              |
    |CHAPTER:    2.0 SA z/OS System Operations Commands            |
    |SECTION:    2.1 System Operations Commands                    |
    |SUBSECTION: 2.1.52 INGLKUP                                    |
    |TOPIC:      Syntax                                            |
    |                                                              |
    |CHANGE:                                                       |
    | Replace the QUAL part of the syntax diagram with:            |
    |                                                              |
    |    .-QUAL=ALL------------.                                   |
    |  --.---------------------.--.-------------.--                |
    |    |        <--------<   |  '-TIMEOUT=nnn-'                  |
    |    '-QUAL=(--.- * --.--)-'                                   |
    |              |-APPC-|                                        |
    |              |-JOB--|                                        |
    |              '-STC--'                                        |
    |                                                              |
    | In the syntax for REQ=ANALYSE add after the STATE parameter: |
    |                                                              |
    |  --.-------------.--.----------.--                           |
    |    '-TIMEOUT=nnn-'  '-WAIT=nnn-'                             |
    |                                                              |
    |TOPIC:      Parameters                                        |
    |                                                              |
    |CHANGE:                                                       |
    | Replace the QUAL parameter description with:                 |
    |                                                              |
    |  QUAL                                                        |
    |      Specifies the type of "job" to be displayed. QUAL can   |
    |      be ALL, JOB, STC, APPC or '*'. The default is ALL. You  |
    |      can specify more than one qualifier by enclosing the    |
    |      qualifiers in parentheses.                              |
    |                                                              |
    | After the STATE parameter add:                               |
    |                                                              |
    |  TIMEOUT                                                     |
    |      Specifies the maximum number of seconds the INGLKUP     |
    |      command waits for responses from the remote system the  |
    |      command was sent to. The maximum is 999 seconds. The    |
    |      default is 30 seconds.                                  |
    |                                                              |
    |  WAIT                                                        |
    |      Specifies the number of seconds to wait before          |
    |      reporting that a timeout occurred if the automation     |
    |      manager does not provide the requested data. The        |
    |      maximum time interval is 999 seconds. If omitted,       |
    |      the time interval is 30 seconds.                        |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 4 --------+
    |                                                              |
    |PROGRAM NUMBER: 5698-SA3                                      |
    |                                                              |
    |TITLE:  System Automation for zOS                             |
    |        Programmer's Reference                   SC34-2650-00 |
    |                                                              |
    |CHAPTER:  2.0           SA z/OS System Operations Commands and|
    |                        Routines                              |
    |TOPIC:    2.1           SA z/OS System Operations Commands    |
    |SUBTOPIC: 2.1.1         Using System Operations Commands for  |
    |                        Programming                           |
    |HEADING:  2.1.11        AOCUPDT                               |
    |                                                              |
    |CHANGE:                                                       |
    | Replace parameter LOG with the following:                    |
    |                                                              |
    | LOG                                                          |
    |    Specifies whether a trace message is written to the       |
    |    NetView log. The message has the following format:        |
    |    AOFRUPDT: system_name resource_name resource_type,        |
    |    STATUS=status                                             |
    |    This specification can be overruled by the global variable|
    |    AOF_AAO_AOCUPDT_LOGGING. A default can be specified by the|
    |    same global variable. If nothing specified the default is |
    |    YES. For more information see 'Customization and          |
    |    Programming, Appendix A: Global Variables'.               |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 4 --------+
    |                                                              |
    |PROGRAM NUMBER: 5698-SA3                                      |
    |                                                              |
    |TITLE:       System Automation for z/OS         SC34-2644-00  |
    |             Customizing and Programming                      |
    |                                                              |
    |CHAPTER      A.0           Appendix A.  Global Variables      |
    |TOPIC        A.2           Read/Write Variables               |
    |                                                              |
    |CHANGE:                                                       |
    | Add the following new entry to table 25:                     |
    |                                                              |
    |AOF_AAO_AOCUPDT_LOGGING|YES|NO   |Specifies whether or not    |
    |                       |         |trace messages should be    |
    |                       |         |written to the NetView log  |
    |                       |         |in case AOCUPDT is invoked  |
    |                       |         |without its LOG parameter   |
    |                       |         |specified.                  |
    |                       |         |The default is YES.         |
    |                       |         |                            |
    |                       |FORCE_YES|Specifies whether or not    |
    |                       |FORCE_NO |trace messages should be    |
    |                       |         |written to the NetView      |
    |                       |         |log overruling the value    |
    |                       |         |specified with the LOG      |
    |                       |         |parameter in the AOCUPDT    |
    |                       |         |invocation.                 |
    |                       |         |                            |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 4 --------+
    |                                                              |
    |PROGRAM NUMBER: 5698-SA3                                      |
    |                                                              |
    |TITLE:  System Automation for zOS                             |
    |        Operator's Commands                      SC34-2649-00 |
    |                                                              |
    |CHAPTER:    2.0         SA z/OS System Operations Commands and|
    |                        Routines                              |
    |TOPIC:      2.1         SA z/OS System Operations Commands    |
    |SUBTOPIC:   2.1.1       Using System Operations Commands      |
    |HEADING:    2.1.33      INGCF                                 |
    |SUBHEADING: 2.1.33.7    Structure Conditions                  |
    |                                                              |
    |CHANGE:                                                       |
    | Replace the text under 'The structure's initial size is less |
    | than its actual size' with the following:                    |
    |                                                              |
    | The SIZE value is greater twice the INITSIZE value.          |
    | The structure can be rebuilt, but a SIZE value that is       |
    | greater than twice the INITSIZE might cause the following:   |
    |                                                              |
    | o  It might be impossible to allocate a structure at a size  |
    |    of INITSIZE, because the amount of control storage that is|
    |    required to  support the SIZE value might actually be     |
    |    larger than INIT SIZE.                                    |
    |                                                              |
    | o  If the allocation succeeds, it might result in a structure|
    |    with a proportionally large amount of its storage allotted|
    |    to structure controls, leaving too few structure objects  |
    |    to be exploited usefully by the associated application.   |
    |                                                              |
    | For example, if you have requested a maximum size that is    |
    | very much larger than the initial size, the system will      |
    | attempt to use a proportionally large amount of the allocated|
    | storage for its controls. The result could be that the       |
    | allocated storage contains control structures for the future |
    | maximum size of the structure and insufficient storage might |
    | remain for the application's initial use.                    |
    |--------------------------------------------------------------|
    |HEADING:    2.1.73      INGSTR                                |
    |                                                              |
    |CHANGE:                                                       |
    | Under subtopic 'Structure Conditions', replace the text under|
    | 'The structure's initial size is less than than its actual   |
    | size' with  the following:                                   |
    |                                                              |
    | The SIZE value is greater twice the INITSIZE value.          |
    | The structure can be rebuilt, but a SIZE value that is       |
    | greater than twice the INITSIZE might cause the following:   |
    |                                                              |
    | o  It might be impossible to allocate a structure at a size  |
    |    of INITSIZE, because the amount of control storage that is|
    |    required to  support the SIZE value might actually be     |
    |    larger than INIT SIZE.                                    |
    |                                                              |
    | o  If the allocation succeeds, it might result in a structure|
    |    with a proportionally large amount of its storage allotted|
    |    to structure controls, leaving too few structure objects  |
    |    to be exploited usefully by the associated application.   |
    |                                                              |
    | For example, if you have requested a maximum size that is    |
    | very much larger than the initial size, the system will      |
    | attempt to use a proportionally large amount of the allocated|
    | storage for its controls. The result could be that the       |
    | allocated storage contains control structures for the future |
    | maximum size of the structure and insufficient storage might |
    | remain for the application's initial use.                    |
    +--------------------------------------------------------------+
    

APAR Information

  • APAR number

    OA41749

  • Reported component name

    SYSTEM AUTO Z/O

  • Reported component ID

    5698SA300

  • Reported release

    330

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2013-03-20

  • Closed date

    2013-07-09

  • Last modified date

    2015-01-22

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    OA42059 UA69803 UA69804 UA69805 UA69806

Modules/Macros

  • AOF#UPDT AOFDOBDS AOFDXDDF AOFD00   AOFFAMSG
    AOFFCMAM AOFFCP33 AOFFTADV AOFFVTDC AOFHENAM AOFJPDBA AOFJPDBI
    AOFJPDFI AOFPHAO0 AOFRAATA AOFRCFGA AOFRUPDT AOFSXDDF DSIAOF98
    HSAPRIXC HWRE330J HWRE340J IHVBCHDM IHVBC2F  IHVBC2X  IHVBPRTM
    IHVJCHD  ING#CF   ING#CFG  ING#LKUP ING#STR  INGEREXC INGH$PLX
    INGJ330  INGJ340  INGRAHCP INGROMXS INGROMX0 INGRVX9A INGRVX9D
    INGRVX90 INGRX279 INGRX910 INGRX919 INGRYDS0 INGRYMV0 INGSAP
    ING00
    

Publications Referenced
SC34257602SC34265000SC34257003SC34264400SC34257502
SC34264900    

Fix information

  • Fixed component name

    SYSTEM AUTO Z/O

  • Fixed component ID

    5698SA300

Applicable component levels

  • R330 PSY UA69803

       UP13/07/12 P F307

  • R331 PSY UA69804

       UP13/07/12 P F307

  • R340 PSY UA69805

       UP13/07/12 P F307

  • R341 PSY UA69806

       UP13/07/12 P F307

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":"SSWRCJ","label":"IBM Tivoli System Automation for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"330","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
22 January 2015