OA42556: 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
    .
    Restrict INGPLEX SLIP SET function to screen sizes not less than
    43 rows.
    .
    IMS sample policy should change OLDS BACKOUT=1 to BACKOUT=2
    .
    Possible corruption of AOFTMSG/AOFTMSX after flat file update.
    This can result ACF members ZxxxAAPL with msg/user Codes and
    Cmds split under two identical headers.
    Some of the CODE/Cmd entries will then not show in the DISPINFO
    display and will not work when used with ISSUEACT/ISSUECMD.
    

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 Hardware validation should ignore status EXCEPTIONS (meaning,
    not all available CPUs have been activated for a system).
    o Possible corruption of AOFTMSG/AOFTMSX after flat file update.
    This can result in ACF members ZxxxAAPL with msg/user Codes and
    Cmds split under two identical headers.
    Some of the CODE/Cmd entries will then not show in the DISPINFO
    display and will not work when used with ISSUEACT/ISSUECMD.
    o When an APL's subcategory is deleted, the old value may not
    be deleted after an INGAMS REFRESH.
    o Enhance the INGOPC help panel.
    o DISPAPG can show the wrong value for field 'Prepare Move'
    after changing the value in the policy.
    
    SA 3.4:
    o The BODYHEADER can be misplaced on SDF panels.
    o Disable the INGPLEX SLIP SET function when the screen size is
    less than 43 rows.
    o When multiple APLs are un-linked (removed) from an APG then
    only the system of the last un-linked resource is indicated as
    changed. As a result, APL fragments may remain in the main
    include member ACFZxxx by mistake.
    o Enhance INGQRY and ING$QRY to support STRTDLY and STRTCYC.
    o Make sure that the length of a minor resource does not
    exceed 32 characters.
    o The *IMS Add-On policy has changed the maximum number of
    OLDS that are allowed to be in a BACKOUT statusfrom one to two.
    o Application types MQ and ITM have been introduced. For MQ,
    any subtype is valid. For ITM, subtypes of blank, KAHAGENT
    and TEMS are valid.
    o DISPINFO can show '>' for SCHEDSS in linemode.
    o Clarifications for help panels of INGDB2, INGDATA, INGAUTO
    and INGY1006I.
    o Enhance the User Response for message INGY1000I and point out
    where the Return and Reason Codes can be found.
    o Enhance INGALERT to handle multi-line messages for EIF events
    and check AOFMSAFE when default safe is empty.
    

Problem conclusion

Temporary fix

Comments

  • Changes have been made to implement the enhancements listed
    above.
    +------ System Automation for z/OS Version 3 Release 4 --------+
    |PROGRAM NUMBER: 5698-SA3                                      |
    |                                                              |
    |TITLE:       System Automation for z/OS          SC34-2650-00 |
    |             Programmer's Reference                           |
    |CHAPTER:     2.0           SA z/OS System Operations Commands |
    |                           and Routines                       |
    |TOPIC:       2.1.26        INGDATA                            |
    |CHANGE:                                                       |
    |  Under heading 'Purpose', change                             |
    |  +-------+-----------+----------------------------------+    |
    |  | Byte  |  Length   |  Description                     |    |
    |  +-------+-----------+----------------------------------+    |
    |  | 203   |  8        |  Category                        |    |
    |  +-------+-----------+----------------------------------+    |
    |  to:                                                         |
    |  +-------+-----------+----------------------------------+    |
    |  | 203   |  10       |  Category                        |    |
    |  +-------+-----------+----------------------------------+    |
    |--------------------------------------------------------------|
    |TOPIC:       2.1.34        INGQRY                             |
    |CHANGE:                                                       |
    |  Under heading 'Parameters', insert the following:           |
    |  STRTCYC                                                     |
    |     Returns the number of start cycles of the resource.      |
    |  STRTDLY                                                     |
    |     Returns the start delay time of the resource.            |
    |--------------------------------------------------------------|
    |TOPIC:       2.1.37        INGRDS                             |
    |CHANGE:                                                       |
    |  Under heading 'IN Predicate', change:                       |
    |  The maximum number of strings is 20.                        |
    |  to:                                                         |
    |  The maximum number of strings is 19.                        |
    |--------------------------------------------------------------|
    |CHAPTER:     2.0           SA z/OS System Operations Commands |
    |                           and Routines                       |
    |TOPIC:       2.3.1         ING$QRY                            |
    |CHANGE:                                                       |
    | Under heading 'Parameters', insert the following:            |
    | STRTCYC                                                      |
    |    Returns the number of start cycles of the resource.       |
    | STRTDLY                                                      |
    |    Returns the start delay time of the resource.             |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 4 --------+
    |PROGRAM NUMBER: 5698-SA3                                      |
    |TITLE:       System Automation for z/OS          SC34-2645-00 |
    |             Planning and Installation                        |
    |                                                              |
    |CHAPTER:     2.0           Installation                       |
    |TOPIC:       2.1.7         Step 6: Customize NetView          |
    |SUBTOPIC:    2.1.7.2       Step 6B: Customize NetView DSIPARM |
    |                           Data Set                           |
    |CHANGE:                                                       |
    | Under heading INGXINIT, add the following to GRPID:          |
    |   The value must be the same as specified for GRPID in the   |
    |   corresponding member HSAPRMxx.                             |
    |--------------------------------------------------------------|
    |CHAPTER:     APPENDIX1.9   Appendix I.  Syntax for HSAPRM00   |
    |CHANGE:                                                       |
    | Under heading GRPID, add the following:                      |
    |   The value must be the same as specified for GRPID in the   |
    |   corresponding member INGXINIT.                             |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 4 --------+
    |PROGRAM NUMBER: 5698-SA3                                      |
    |TITLE:       System Automation for z/OS          SC34-2648-00 |
    |             Messages and Codes                               |
    |                                                              |
    |CHAPTER:     9.0           Messages ING001I to INGY1203I      |
    |TOPIC:       9.413         INGY1006I                          |
    |                                                              |
    |CHANGE:                                                       |
    |  Add the following to the end of the User Response:          |
    |    Verify that an automation manager was started. Make sure  |
    |    that the GRPID specifications in member HSAPRMxx and the  |
    |    corresponding DSIPARM member INGXINIT are identical.      |
    |--------------------------------------------------------------|
    |TOPIC:       9.407         INGY1000I                          |
    |SUBTOPIC:    User Response                                    |
    |CHANGE:                                                       |
    | User Response: Examine the return and reason codes from      |
    |                the service call and contact your system      |
    |                programmer.                                   |
    | to                                                           |
    | User Response: For module names prefixed with INGPX see      |
    |                also IBM Tivoli System Automation for z/OS    |
    |                Messages and Codes Appendix G, Sysplex        |
    |                Communication Services Return and Reason      |
    |                Codes.                                        |
    |                Examine the return and reason codes from      |
    |                the service call and contact your system      |
    |                programmer.                                   |
    +--------------------------------------------------------------+
    +------ 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 |
    |TOPIC:       2.1.32        INGAUTO                            |
    |                                                              |
    |CHANGE:                                                       |
    |  Replace the text under heading 'Purpose' with the following:|
    |  INGAUTO lets you change the settings of the automation flags|
    |  for a specific resource, for MVSESA, SUBSYSTEM or DEFAULTS  |
    |  resources, or for a minor resource under one of those major |
    |  resources.  You can change the setting to ON, OFF, EXITS or |
    |  LOG either indefinitely or for a specific period of time.   |
    |  You can also ask for a flag to be set back to the value     |
    |  specified in the policy database.                           |
    |                                                              |
    |CHANGE:                                                       |
    |  Under heading 'Syntax', replace this part                   |
    |      -.-DEFAULTS------.-                                     |
    |       |-SUBSYSTEM-----|                                      |
    |       |-MVSESA--------|                                      |
    |       |-resname-------|                                      |
    |       '-subcomponents-'                                      |
    |  with the following:                                         |
    |      .- MVSESA ---------.                                    |
    |    --+------------------+----.-----------------------.-->    |
    |      |- DEFAULTS -------|    |     <-----------<     |       |
    |      |- SUBSYSTEM ------|    '-----.subcomponent-----'       |
    |      '- resname --------'                                    |
    |CHANGE:                                                       |
    |  Under heading 'Parameters', replace the text                |
    |   If you do not specify a subsystem, a menu is displayed     |
    |   where you can specify it.                                  |
    |  with the following:                                         |
    |   If you do not specify a resource (MVSESA, SUBSYSTEM,       |
    |   DEFAULTS, resname or subcomponent) and are running in full |
    |   screen mode, a menu will appear prompting you for a        |
    |   resource name. If you are in line mode, a resource is a    |
    |   required parameter.                                        |
    |CHANGE:                                                       |
    |  Under heading 'resname', replace the existing text with the |
    |  following:                                                  |
    |   Specifies the name of a particular resource, for example,  |
    |   a subsystem name like JES2 or a resource under MVSESA such |
    |   as WTOBUF. You can specify any resource known to the       |
    |   Automation Agent.                                          |
    |   Wildcards are supported, for example, IMS* or *PRD.        |
    |CHANGE:                                                       |
    |  Under heading 'subcomponent', add the following to the      |
    |  existing text:                                              |
    |   When specifying a subcomponent without specifying a major  |
    |   resource, MVSESA will be used as major resource. The       |
    |   period (.) in front of the subcomponent must then be       |
    |   omitted.                                                   |
    +--------------------------------------------------------------+
    +------ 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 |
    |TOPIC:       2.1.45        INGFILT                            |
    |                                                              |
    |CHANGE:                                                       |
    |  Under heading 'Syntax', filter_criteria, replace the        |
    |  CATEGORY specifications with the following:                 |
    |      -.---------------------------------------.              |
    |       '-CATEGORY=-.-*----------------------.--'              |
    |                   |    <--------------<    |                 |
    |                   '-(---.-CICS-------.---)-'                 |
    |                         |-DB2--------|                       |
    |                         |-IMS--------|                       |
    |                         |-IMAGE------|                       |
    |                         |-INFOSPHERE-|                       |
    |                         |-ITM--------|                       |
    |                         |-JES2-------|                       |
    |                         |-JES3-------|                       |
    |                         |-LIFELINE---|                       |
    |                         |-MQ---------|                       |
    |                         |-OPC--------|                       |
    |                         |-TCPIP------|                       |
    |                         '-USS--------'                       |
    |CHANGE:                                                       |
    |  Under sub-heading 'Resource category', replace the existing |
    |  text with the following:                                    |
    |  Resource category                                           |
    |    The list of categories that the resource belongs to. It is|
    |    one of CICS, IMS, DB2, OPC, USS, IMAGE, JES2, JES3, TCPIP,|
    |    INFOSPHERE, LIFELINE, MQ or ITM.                          |
    |--------------------------------------------------------------|
    |CHAPTER:     2.0           SA z/OS System Operations Commands |
    |TOPIC:       2.1.51        INGLIST                            |
    |                                                              |
    |CHANGE:                                                       |
    |  Under heading 'Syntax', filter_criteria, replace the        |
    |  CATEGORY specifications with the following:                 |
    |                                                              |
    |      -.---------------------------.-                         |
    |       '-CATEGORY=-.-CICS-------.--'                          |
    |                   |-DB2--------|                             |
    |                   |-IMS--------|                             |
    |                   |-IMAGE------|                             |
    |                   |-INFOSPHERE-|                             |
    |                   |-ITM--------|                             |
    |                   |-JES2-------|                             |
    |                   |-JES3-------|                             |
    |                   |-LIFELINE---|                             |
    |                   |-MQ---------|                             |
    |                   |-OPC--------|                             |
    |                   |-TCPIP------|                             |
    |                   '-USS--------'                             |
    |--------------------------------------------------------------|
    |CHANGE:                                                       |
    |  Replace this bullet:                                        |
    |  o The Subtype field shows the subtype of the resource. This |
    |    applies to resources of category CICS, DB2, IMS,          |
    |    INFOSHERE, LIFELINE and OPC.                              |
    |  with the following:                                         |
    |  o The Subtype field shows the subtype of the resource. This |
    |    applies to resources of category CICS, DB2, IMS, OPC,     |
    |    INFOSPHERE, LIFELINE, MQ and ITM.                         |
    |--------------------------------------------------------------|
    |CHAPTER:     2.0           SA z/OS System Operations Commands |
    |TOPIC:       2.1.42        INGDB2                             |
    |                                                              |
    |CHANGE:                                                       |
    |  Under heading 'Return Codes', add the following Note at the |
    |  end of the explanation of return code 1:                    |
    |  Note:                                                       |
    |  When your INGDB2 CHECK_INDOUBT command is part of your DB2  |
    |  shutdown commands in the policy and you have return-code    |
    |  checking enabled (specified '*' in the 'AutoFn' field)      |
    |  System Automation will not issue any other shutdown         |
    |  commands. The Automation Status of the DB2 will be set to   |
    |  Problem. Manual intervention will be required.              |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 4 --------+
    |PROGRAM NUMBER: 5698-SA3                                      |
    |TITLE:       System Automation for z/OS         SC34-2648-00  |
    |             Messages and Codes                               |
    |                                                              |
    |CHAPTER      2.0           Messages AOF000I to AOFS820I       |
    |                                                              |
    |CHANGE:                                                       |
    | Add the following new message (topic):                       |
    |                                                              |
    | 2.nnn  AOF016I                                               |
    |                                                              |
    | AOF016I   Too few screen rows (min. nn required).            |
    |                                                              |
    | Explanation:  The function requires at least the indicated   |
    | number of rows for displaying the panel.                     |
    |                                                              |
    | System Action:  The function is terminated.                  |
    |                                                              |
    | Operator Response:  Use a terminal that fits the required    |
    | screen size and re-do the function.                          |
    |                                                              |
    | System Programmer  Response: None.                           |
    |                                                              |
    | Classes:  None.                                              |
    +--------------------------------------------------------------+
    +------ 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:     17.0          SA z/OS User Exits                 |
    |TOPIC:       17.6          Command Exits                      |
    |SUBTOPIC:    17.6.13       AOFEXC12                           |
    |                                                              |
    |CHANGE:                                                       |
    | Replace the sentence:                                        |
    |                                                              |
    | The exit allows you to perform authorization checking of the |
    | commands scheduled via the TWS batch interface (EVJRYCMD)    |
    | against the user ID of the batch job requesting the command. |
    | with the following text:                                     |
    |                                                              |
    | The exit allows you to perform authorization checking of the |
    | commands scheduled via Batch Command Interface against the   |
    | user ID of the batch job requesting the command, or any other|
    | checking you might want to perform.                          |
    |                                                              |
    | Note:                                                        |
    | The Batch Command Interface used to be known as EVJRYCMD.    |
    | REXX module EVJRYCMD was added as AOFRYCMD to the            |
    | ING.SINGTREX library. For migration purposes, EVJRYCMD also  |
    | resides in ING.SINGNREX library. It is recommended to use    |
    | AOFRYCMD in the future and to adapt the automation           |
    | environment accordingly.                                     |
    | For a detailed description of AOFRYCMD, refer to the         |
    | Customizing and Programming manual.
    +--------------------------------------------------------------+
    

APAR Information

  • APAR number

    OA42556

  • Reported component name

    SYSTEM AUTO Z/O

  • Reported component ID

    5698SA300

  • Reported release

    340

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-06-13

  • Closed date

    2013-10-17

  • Last modified date

    2013-11-04

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

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

    OA43045 UA71099 UA71100 UA71101 UA71102

Modules/Macros

  •    AOFDMMSG AOFDMNFY AOFDOBDS AOFDODDF AOFDXDDF
    AOFD04   AOFFFAPL AOFFFMNR AOFFFMSG AOFFLMSG AOFFPFL1 AOFFVTDB
    AOFFXRSC AOFHLN00 AOFHLPA0 AOFHMRES AOFJPDB7 AOFRACFC AOFRATHR
    AOFRCAPM AOFRSCMD AOFRSGAC AOFRSGCR AOFRSGHM AOFRSGTM AOFRSRPY
    AOFRUPDT AOFRVDA8 AOFR3CFG AOFTLP1  AOF01    DSIAOF01 EVEERTRN
    EVEES100 EVIECT0X EVISTRCT EVJH$ST  HSAAPIZZ HSACMAIN IHVCCTY
    IHVDBRH  IHVDMSW  IHVDVEPM IHVIREX  IHVNTIM  IHVQDPH  IHVQDPL
    IHVQDPR  IHVZSCCM ING$QRY  ING#$QRY ING#AUTO ING#DATA ING#DB2
    ING#FILT ING#LIST ING#QRY  INGH$PLX INGH$ST  INGLX250 INGPYQRY
    INGPYVET INGRALRT INGRDSTS INGRDTTH INGRVALT INGRVAL1 INGRVMSG
    INGRX250 INGRX270 INGRX271 INGRX809 INGY100
    

Publications Referenced
SC34264900 SC34264400 SC34265000 SC34264500 SC34264800

Fix information

  • Fixed component name

    SYSTEM AUTO Z/O

  • Fixed component ID

    5698SA300

Applicable component levels

  • R330 PSY UA71099

       UP13/10/19 P F310

  • R331 PSY UA71100

       UP13/10/19 P F310

  • R340 PSY UA71101

       UP13/10/19 P F310

  • R341 PSY UA71102

       UP13/10/19 P F310

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.



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Tivoli System Automation for z/OS

Software version:

340

Reference #:

OA42556

Modified date:

2013-11-04

Translate my page

Machine Translation

Content navigation