IBM Support

OA47266: 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
    .
    Adjust sort order for DISPSTAT output in line mode to make it
    consistent with previous releases.
    .
    AOF760E NOVALUE CONDITION TRAPPED IN INGRVIN0 LINE 247 (CODE
    N/A) DESCRIPTION PGSTART
    can occur for INGLIST command after returning from commands
    like A Update, B Start, C Stop.
    .
    AOF760E NOVALUE CONDITION TRAPPED IN INGRYAM0 LINE 176 (CODE
    N/A) DESCRIPTION INDATA.13
    occurs when issuing INGAMS TARGET=target from a system running
    SA 3.5 and a target running a down-level release.
    .
    Displaying Dependent Regions via INGIMS REQ=DEP can result in
    AOF760E NOVALUE CONDITION TRAPPED IN EVIRYDP0 LINE 163 (CODE
    N/A) DESCRIPTION INDATA.20
    SA 3.4 only:
    MsgAOFS512I Field overlapping occurred in SYSTEM can be issued
    in a loop with incorrect definitions.
    .
    A NOVALUE condition can occur in INGRPSDF and INGRSDF0 when an
    SDF tree is missing level 1 (root level).
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All SA z/OS V3R4 and V3R5 customers.         *
    ****************************************************************
    * PROBLEM DESCRIPTION: see description below...                *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    SA 3.4:
    o When incorrect SDF definitions are detected then MsgAOFS512I,
    indicating 'Field overlapping' can be issued in a loop.
    
    SA 3.4 & SA 3.5:
    o Tolerate empty lines in DSIPARM member INGXINIT.
    o The on-line help for the INGRDS command should be enhanced.
    o For flat file update, the line 'Action - CMD' should not have
    to start at position 7.
    o When renaming a sysplex GRP which has multiple sysplex APGs
    linked and the first has no automation name, a NOVALUE condition
    can occur in AOFF#RSC, line 484.
    
    SA 3.5:
    o New msgAOFS523I is introduced when duplicate SDF panel or
    duplicate tree definitions are detected.
    o Enhance INGRSDF0 to evaluate AOFEXX05 only once.
    o Enhance SA initialization to re-evaluate JES and OMVS in case
    the UP-message was missed when the Automation Table was not
    loaded yet.
    o Monitor routine INGROMON has been enhanced. It is no longer
    required to wait for AT load completion when OMVS is starting
    but is not fully initialized yet.
    o Config Refresh Monitoring should only report a problem in
    SDF (status CFG_PROB) when a configuration refresh is in
    progress.
    o Enhance sample JCL INGXJAVA to add parameter TIME=1440 to
    avoid potential timeouts.
    o *E2E Add-on Sample Policy has been enhanced to add the ASID
    parameter to the stop and cancel commands since two address
    spaces with the same jobname exist.
    o Add-on policy *SAPSRV has been enhanced:
      - Make Upper Class of SAP Router SAPSYSRT independent of SAP
        application stack.
      - Exploitation of SAP Web service function StopBypassHA for
        faster stop of SCS. Requires SAP kernel 7.21 level 211 or
        kernel 7.42 level 8 or higher.
      - Avoid unnecessary SCS MOVE in case SAP replication was
        stopped.
      - Provide new INGSAP tar file.
    o When users have their own policies defined via selection 0.10
    'Policy - Modify SA z/OS policy definitions' and within their
    own processing an ISPF table is created, then this table is not
    available when the users open their policy in BROWSE mode. As a
    result, various ISPF or REXX errors could occur.
    o The Activity log for service periods has been changed.
    The stem with the field names for service periods was not
    initialized. As a result, the Activity Log showed the variables
    itself instead of the field names.
    o Enhance msgAOFD078M 'AT/MRT/MPF data conflict' to also mention
    the possibility of conflicting MPF specifications.
    o A possible error in field 'Mixed case' for APL data has been
    addressed.
    o A misleading error message is displayed on the AUTOMATION
    CONSOLE policy when a Console Name with more than 8 characters
    is specified (Too many Volumes - AOFD222H Only 8 page data set
    volumes can be specified).
    o Misleading error message for AT override of IEF4xxxx messages
    can occur. For messages with prefix IEF4 the variable SVJOB is
    set by the BEGIN statement for that IEF4 message block.
    This BEGIN statement is not part of the individual AT overrides,
    so an AT syntax check always shows the following error message
    when the override is modified:
    CNM592E VARIABLE "SVJOB" NOT DEFINED WITHIN THE SCOPE OF THIS
    ENTRY.
    o MsgAOFD211H can be issued when a new PDB is created and the
    SA Customization Dialogs are then started in another ISPF
    screen.
    o There is a problem with ISPF split screen and allocation of
    AOFTABL. When an APL entry is opened and policies are displayed
    (panel AOFGEPOL), then another new dialog in split screen
    cannot be started due to AOFTABL in use. The error message is:
    IKJ56246I DATA SET RTL.USER.V350.SRV.AINGITBL NOT ALLOCATED,
    FILE IN USE.
    Start of SA for z/OS Customization Dialog failed.
    Error in INGDLG2 > Return code 12 from ALLOCATE for AOFTABL
    data set user.....AINGITBL.
    o AOFD077R This message is already defined with AT, MRT, or MPF
    data. This message can be issued inappropriately during file
    update and an attempt is made to change a message id.
    o An MRT entry might not be build in special situations.
    For instance, a message has the following specifications:
    No command etc defined, no AT specification and the following
    MRT definition:
    Automate . . . . . . . . . NO
    Suppress from console  . . YES
    Then the Message Automation Overview panel shows the correct
    generated MRT entry :
    UPON ( MSGID = 'KK002' )
    REVISE('N' AUTOMATE)
    REVISE('N' DISPLAY)
    However, the appropriate MRT entry is not built.
    o When used with OUTMODE=LINE, the sort order of the command
    output of the following commands might not be as expected:
    DISPGW, INGIMS REQ=DEP, INGAMS, DISPSTAT, DISPMTR, INGPAC and
    INGLIST.
    o Prevent potential NOVALUE conditions for INGLIST after
    returning from commands like A Update, B Start, C Stop.
    o Prevent potential NOVALUE conditions for INGAMS with
    TARGET=target from a system running SA 3.5 with a target
    running a down-level release.
    

Problem conclusion

Temporary fix

Comments

  • Changes have been made to implement the enhancements listed
    above.
    
    +------ System Automation for z/OS Version 3 Release 5 --------+
    |                                                              |
    |PROGRAM NUMBER: 5698-SA3                                      |
    |                                                              |
    |TITLE:       System Automation for z/OS         SC34-2719-00  |
    |             Messages and Codes                               |
    |                                                              |
    |CHAPTER      3. Messages AOFS000I to AOFS820I                 |
    |TOPIC:       AOFS523I                                         |
    |                                                              |
    |CHANGE:                                                       |
    |                                                              |
    | Insert the following new topic/message:                      |
    |                                                              |
    | AOFS523I  Duplicate aa definitions found for bb.             |
    |                                                              |
    | Explanation:                                                 |
    |                                                              |
    | The task AOFTDDF detected duplicate panel or tree definitions|
    | for the indicated name. The actual definitions may differ or |
    | not. SDF always uses the definitions that have been processed|
    | first. However, the processing sequence can differ from the  |
    | sequence of the definitions.                                 |
    |                                                              |
    |    The variable aa shows the type of the definition.         |
    |                                                              |
    |    The variable <mv>bb</mv> shows the name of the panel or   |
    |    the tree.                                                 |
    |                                                              |
    | System Action:                                               |
    |                                                              |
    | The duplicate definition has been deleted.                   |
    |                                                              |
    | Operator Response:                                           |
    |                                                              |
    | None.                                                        |
    |                                                              |
    | System Programmer Response:                                  |
    |                                                              |
    | Remove the duplicate definitions.                            |
    |                                                              |
    | In case the actual definitions differed in some data issue   |
    | the command RESYNC SDFDEFS. This will adjust the definitions |
    | used by SDF.                                                 |
    |                                                              |
    |--------------------------------------------------------------|
    |                                                              |
    |TITLE:       System Automation for z/OS         SC34-2748-00  |
    |             Programmer's Reference                           |
    |                                                              |
    |CHAPTER      3. Monitoring Routines                           |
    |TOPIC:       INGROMON                                         |
    |                                                              |
    |CHANGE:                                                       |
    |                                                              |
    | Under 'Return Codes', replace                                |
    |                                                              |
    | 4 OMVS is starting. INGROMON will always ensure that the AT  |
    |   is loaded prior to returning this code.                    |
    |                                                              |
    |with the following:                                           |
    |                                                              |
    | 4 OMVS is starting.                                          |
    |                                                              |
    |--------------------------------------------------------------|
    |                                                              |
    |TITLE:       System Automation for z/OS         SC34-2717-00  |
    |             Defining Automation Policy                       |
    |                                                              |
    |CHAPTER      Appendix B. More about Using the Customization   |
    |                         Dialog                               |
    |TOPIC:       Extending Policy Definitions                     |
    |                                                              |
    |CHANGE:                                                       |
    |                                                              |
    | In Figure 261. Define Policy Selection Panel, after line     |
    |                                                              |
    |  Edit Action. . CMD(AOFFLCVW DISPL,D0M)                      |
    |                                                              |
    | add the following line:                                      |
    |                                                              |
    |  ISPF Tables. . ___________________________________________  |
    |                                                              |
    |CHANGE:                                                       |
    |                                                              |
    | After the explanation for 'Edit Action', add the following:  |
    |                                                              |
    |  ISPF Tables                                                 |
    |    Allows to specify a list of ISPF tables which are used in |
    |    this policy. All table names specified here are provided  |
    |    for that policy if invoked in BROWSE mode.                |
    |    This specification is optional and only needed for BROWSE.|
    |                                                              |
    +--------------------------------------------------------------+
    

APAR Information

  • APAR number

    OA47266

  • Reported component name

    SYSTEM AUTO Z/O

  • Reported component ID

    5698SA300

  • Reported release

    340

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2015-03-09

  • Closed date

    2015-06-30

  • Last modified date

    2016-07-13

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

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

    UA77942 UA77943 UA77944 UA77945 UA77946 UA77947

Modules/Macros

  • AOFDBPPP AOFDMDDF AOFDMINI AOFDMMSG AOFDMPTI AOFD07   AOFD22
    AOFD30   AOFD97   AOFF#CHK AOFF#RSC AOFFASHC AOFFBRP1 AOFFENAM
    AOFFENA1 AOFFOPOL AOFFOPO1 AOFFPDB  AOFFPFLA AOFFPMAN AOFFPSCN
    AOFFSPD1 AOFFSVP0 AOFFTADV AOFFVTDB AOFFVTDC AOFGCPO2 AOFHCPO2
    AOFJPDBE AOFJPDBI AOFPIEC0 AOFRACF0 AOFRANT3 AOFRSDFD AOFR2GL
    AOFS52   AOFTLP1  AOFT0POL EVIRYDP0 IHVBDMPM IHVDDFH  IHVSTAC
    IHVSTADM IHVSTASM IHVSTAUM IHVTCTEM IHVTQHRM IHVTRTEM ING#RDS
    INGDLG2  INGHPREF INGPXPRS INGROMON INGRPSDF INGRSDF0 INGRX271
    INGRYAM0 INGRYDS0 INGRYMO0 INGRYPA0 INGRYPA1 INGRYST0 INGR1FPR
    INGR1GAT INGR1IGT INGSAP   INGXJAVA INGXRPRT
    

Publications Referenced
SC34271900SC34274800SC34271700  

Fix information

  • Fixed component name

    SYSTEM AUTO Z/O

  • Fixed component ID

    5698SA300

Applicable component levels

  • R340 PSY UA77942

       UP15/07/07 P F507

  • R341 PSY UA77945

       UP15/07/07 P F507

  • R35D PSY UA77943

       UP15/07/07 P F507

  • R35F PSY UA77946

       UP15/07/07 P F507

  • R350 PSY UA77944

       UP15/07/07 P F507

  • R351 PSY UA77947

       UP15/07/07 P F507

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":"340","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
13 July 2016