IBM Support

OA46166: 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
    .
    Issuing NetView's TIMER command results in
    EZL271E PROGRAM EZLE6000 FAILED - LINE 4898 CONTAINS A VARIABLE
    WITH NOVALUE - INGRYCMD_RC
    when COMMON.EZLRMTTIMER is set to 'SA' in CNMSTYLE.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All SA z/OS V3R3, V3R4 and V3R5 customers.   *
    ****************************************************************
    * PROBLEM DESCRIPTION: see description below...                *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    SA 3.4 & SA 3.5:
    o Enhance INGMSGSA to only trap msgCNM226I when SYSOPS TOWER is
    enabled.
    o Enhance AOCQRY to also set tglobals SUBSMSGPREFIX and
    SUBPMSGPREFIX.
    o Change *ProcOps Sample Policy to correct data in PSM
    processor VCPC
    o Enhance the INGRDS command to support the TARGET parameter for
    selected functions.
    For more information, refer to this link: https://ibm.biz/BdEHwQ
    o The E2E Adapter start script (ingadapter.sh) and configuration
    file ingadapter.properties introduces the environment variable
    E2E_JAVA_HOME.
    Also, E2E_ECHO=ON now writes more debug statements.
    o Enhance msgEVJ120I to append the TWS job's stepname.
    o When editing an RDS tables using INGRCRDX and attempting to
    illegally change a table field, then msgING332I Command
    execution failed RC=21 is issued. The content of the table
    should not be lost.
    
    SA 3.5:
    o Enhance Customization Dialog panel AOFPITI1 (Timer
    Definitions) with additional fields 'Notify' and 'Remark'.
    'Notify' specifies that a BNH549I message will be sent as
    notification. 'Remark' can be used to add comments to CHRON
    commands. The SETTIMER command also offers those two new fields.
    o Enhance INGREQ help panel INGH$RU to clarify start/stop types
    for APGs.
    o Enhance the build to only build pacing gates for systems where
    they are used.
    o When Temporary Data Set HLQ/TEMPHLQ is not defined then SA
    should use the first qualifier of the automation status file.
    This will avoid messages
    DSI238I ALLOCATE COMMAND FAILED, INVALID PARAMETER: DATASET
    and
    AOF098I COMMAND FAILED - REFER TO NETVIEW LOG
    for certain INGPLEX commands.
    o Enhance *SAPSRV policy:
     - new ING_sap.tar
     - Remove PRESTART SETOMVS from SAPSIDA_STA and SAPSIDJ_STA
     - SAP Web Dispatcher resources uses SAP sapstartsrv framework
     - Automation scripts use cross platform utility functions
    o Remove debug message from INGRPLEX indicating 'LOOP Entries'.
    o Prevent NetView's TIMER command to fail with message
    EZL271E PROGRAM EZLE6000 FAILED - LINE 4898 CONTAINS A VARIABLE
    WITH NOVALUE - INGRYCMD_RC
    when COMMON.EZLRMTTIMER is set to 'SA' in CNMSTYLE.
    o When creating a new Processor entry, the entered values 'M'
    or 'P' (for processor type Mainframe or PSM) should
    automatically be expanded to the full value.
    Likewise, for processor mode (LPAR, ESA) the entered values 'L'
    or 'E' should automatically be expanded to the full value.
    

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:  Programmer's Reference                  SC34-2650-00  |
    |                                                              |
    |Chapter 2. SA z/OS System Operations Commands                 |
    |Topic:     AOCQRY                                             |
    |Subtopic:  Table 4. AOCQRY Subsystem Task Global Variables    |
    |                                                              |
    |Change:                                                       |
    |Add the following to the Description of Task Global Variable  |
    |SUBSCMDPFX:                                                   |
    |                                                              |
    |   If more than 1 value is available a blank delimited        |
    |   list is presented.                                         |
    |                                                              |
    |Insert the following new Task Global Variable into Table 4:   |
    |+--------------+---------------------------------------------+|
    ||SUBSMSGPREFIX |The application message prefix from the      ||
    ||              |automation control file.                     ||
    ||              |If more than 1 value is available a blank    ||
    ||              |delimited list is presented.                 ||
    |+--------------+---------------------------------------------+|
    |                                                              |
    |Add the following to the Description of Task Global Variable  |
    |SUBPCMDPFX:                                                   |
    |   If more than 1 value is available a blank delimited        |
    |   list is presented.                                         |
    |                                                              |
    |Insert the following new Task Global Variable into Table 4:   |
    |+--------------+---------------------------------------------+|
    ||SUBPMSGPREFIX |The parent message prefix from the automation||
    ||              |control file.                                ||
    ||              |If more than 1 value is available a blank    ||
    ||              |delimited list is presented.                 ||
    |+--------------+---------------------------------------------+|
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 4 --------+
    |PROGRAM NUMBER: 5698-SA3                                      |
    |TITLE:  Messages and Codes                      SC34-2648-00  |
    |                                                              |
    |Chapter 5. Messages EVJ000I to EVJ440I (TWS Automation)       |
    |Topic:     EVJ120I                                            |
    |                                                              |
    |Change:                                                       |
    | In the message text, add 'stepname' to the end (after job#). |
    |                                                              |
    | At the end of the Explanation, add the following:            |
    | The variable stepname shows the TWS job's stepname.          |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 4 --------+
    |PROGRAM NUMBER: 5698-SA3                                      |
    |TITLE:  TWS Automation Programmer's                           |
    |        Reference and Operator's Guide          SC34-2651-00  |
    |                                                              |
    |Chapter 12. TWS Automation Common Routines and Data Areas     |
    |Topic:      Automation Routines                               |
    |Subtopic:   EVJEAC04                                          |
    |                                                              |
    |Change:                                                       |
    | Under heading 'Usage', replace                               |
    | EVJ120I applid iatime opnum job status wsname errcode abcode |
    |         usercode job#                                        |
    | with:                                                        |
    | EVJ120I applid iatime opnum job status wsname errcode abcode |
    |         usrcode job# stepname                                |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 5 --------+
    |PROGRAM NUMBER: 5698-SA3                                      |
    |TITLE:  Programmer's Reference                  SC34-2748-00  |
    |                                                              |
    |Chapter 2. SA z/OS System Operations Commands                 |
    |Topic:     AOCQRY                                             |
    |Subtopic:  Table 4. AOCQRY Subsystem Task Global Variables    |
    |                                                              |
    |Change:                                                       |
    |Add the following to the Description of Task Global Variable  |
    |SUBSCMDPFX:                                                   |
    |   If more than 1 value is available a blank delimited        |
    |   list is presented.                                         |
    |                                                              |
    |Insert the following new Task Global Variable into Table 4:   |
    |+--------------+---------------------------------------------+|
    ||SUBSMSGPREFIX |The application message prefix from the      ||
    ||              |automation control file.                     ||
    ||              |If more than 1 value is available a blank    ||
    ||              |delimited list is presented.                 ||
    |+--------------+---------------------------------------------+|
    |                                                              |
    |Add the following to the Description of Task Global Variable  |
    |SUBPCMDPFX:                                                   |
    |   If more than 1 value is available a blank delimited        |
    |   list is presented.                                         |
    |                                                              |
    |Insert the following new Task Global Variable into Table 4:   |
    |+--------------+---------------------------------------------+|
    ||SUBPMSGPREFIX |The parent message prefix from the automation||
    ||              |control file.                                ||
    ||              |If more than 1 value is available a blank    ||
    ||              |delimited list is presented.                 ||
    |+--------------+---------------------------------------------+|
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 5 --------+
    |PROGRAM NUMBER: 5698-SA3                                      |
    |TITLE:  Messages and Codes                      SC34-2719-00  |
    |                                                              |
    |Chapter 5. Messages EVJ000I to EVJ440I (TWS Automation)       |
    |Topic:     EVJ120I                                            |
    |                                                              |
    |Change:                                                       |
    | In the message text, add 'stepname' to the end (after job#). |
    |                                                              |
    | At the end of the Explanation, add the following:            |
    | The variable stepname shows the TWS job's stepname.          |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 5 --------+
    |PROGRAM NUMBER: 5698-SA3                                      |
    |TITLE:  TWS Automation Programmer's Reference                 |
    |        and Operator's Guide                    SC34-2749-00  |
    |                                                              |
    |Chapter 12. TWS Automation Common Routines and Data Areas     |
    |Topic:      Automation Routines                               |
    |Subtopic:   EVJEAC04                                          |
    |                                                              |
    |Change:                                                       |
    | Under heading 'Usage', replace                               |
    | EVJ120I applid iatime opnum job status wsname errcode abcode |
    |         usercode job#                                        |
    | with:                                                        |
    | EVJ120I applid iatime opnum job status wsname errcode abcode |
    |         usrcode job# stepname                                |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 5 --------+
    |PROGRAM NUMBER: 5698-SA3                                      |
    |TITLE:  Defining Automation Policy              SC34-2717-00  |
    |                                                              |
    |Chapter 4. Entry Type Reference                               |
    |Topic:     Timers Entry Type                                  |
    |Subtopic:  TIMERS Policy Item                                 |
    |                                                              |
    |Change:                                                       |
    |In Figure 200. Timer Definitions Panel 2, insert the following|
    |two lines in panel AOFPITI1 (Timer Definitions) just before   |
    |the 'CHRON parameters  .' field:                              |
    |                                                              |
    | Notify  . . . . . . _______________________________________  |
    | Remark  . . . . . . _______________________________________  |
    |--------------------------------------------------------------|
    |Change:                                                       |
    | Replace the text after the table describing the 'Time        |
    | interval' and 'When the timer should expire' with the        |
    | following:                                                   |
    |                                                              |
    | Notify   specifies that a BNH549I message will be sent as    |
    |          notification when certain events occur in the       |
    |          processing of then CHRON  command. It supports four |
    |          event types IGNORE, PURGE, REMOVE and RUN.          |
    |          For each event type specify a list of operator IDs  |
    |          or group names. You may specify more than one event,|
    |          e.g. IGNORE=(OPER1 OPER2) PURGE=(OPER3).            |
    | Remark   can be any string specifying informational data.    |
    | CHRON parameter                                              |
    |          can be any combination of NetView CHRON timer       |
    |          parameters like RECOVERY, INTERVAL, CALENDAR, etc.  |
    |          The following parameters must not be specified as   |
    |          those are automatically created from the definitions|
    |          made on this and the preceding panel:  AT, AFTER,   |
    |          EVERY, SAVE/NOSAVE, GMT/LOCAL, ROUTE, ID, COMMAND.  |
    |          If the 'Notify' and/or 'Remark' fields are used also|
    |          the following parameters must not be specified:     |
    |          NOTIFY, REM.                                        |
    |                                                              |
    | For more details about the NetView CHRON commands that       |
    | SA z/OS generates during initialization see the online help. |
    |--------------------------------------------------------------|
    |Chapter 4. Entry Type Reference                               |
    |Topic:     Creating a New Group                               |
    |                                                              |
    |Change:                                                       |
    | Under heading 'Entry name', replace the complete Note with   |
    | the following:                                               |
    |                                                              |
    | Note: The entry name of a group with group type SYSPLEX      |
    |       represents the SAplex name and can be used in the      |
    |       TARGET parameter of the SA z/OS commands. If the       |
    |       specified name is longer than 8 characters a truncation|
    |       of the name may occur on certain SA z/OS full screen   |
    |       command panels.                                        |
    |       If the name is to be used in the Status Display        |
    |       Facility (SDF) it must not be longer than 16           |
    |       characters.                                            |
    |--------------------------------------------------------------|
    |Topic:     SYSPLEX Policy Item                                |
    |                                                              |
    |Change:                                                       |
    | Under heading 'Temporary Data Set HLQ' add the following to  |
    | the end of the description:                                  |
    |                                                              |
    | If nothing specified, the first qualifier of the automation  |
    | status file (AOFSTAT) is used.                               |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 5 --------+
    |PROGRAM NUMBER: 5698-SA3                                      |
    |TITLE:  Operator's Commands                     SC34-2720-00  |
    |                                                              |
    |Chapter 2. System Operations Commands                         |
    |Topic:     SETTIMER                                           |
    |                                                              |
    |Change:                                                       |
    | In Figure 123. SETTIMER Command Dialog Panel: Adding or      |
    | Changing Timers, insert the following two lines just before  |
    | the 'CHRON parms =>' field:                                  |
    |                                                              |
    | Notify      => _____________________________________________ |
    | Remark      => _____________________________________________ |
    |--------------------------------------------------------------|
    |Change:                                                       |
    | After the table with 'Timer Type' and 'Fields', replace the  |
    | text:                                                        |
    |                                                              |
    | Use the CHRON Parameters field to specify additional CHRON   |
    | parameters, such as REFRESH or NOTIFY. You can also specify  |
    | suboptions of the EVERY parameter such as REMOVE, REMAFTER,  |
    | DAYSMON, CALENDAR, MXREPEAT, OFF, or FOR.                    |
    |                                                              |
    | with the following new text:                                 |
    |                                                              |
    | Use the Notify field to specify the value for CHRON parameter|
    | NOTIFY which defines to whom a BNH549I message will be sent  |
    | as notification when certain events occur in the processing  |
    | of the CHRON command. It supports four event types IGNORE,   |
    | PURGE, REMOVE and RUN. The field is automatically enclosed in|
    | parentheses.                                                 |
    | Use the Remark field to specify the value for the CHRON      |
    | parameter REM which can be any string specifying             |
    | informational data. The field is automatically enclosed in   |
    | quotes.                                                      |
    | Use the CHRON Parameters field to specify additional CHRON   |
    | parameters, such as REFRESH or RECOVERY.                     |
    | You can also specify suboptions of the EVERY parameter such  |
    | as REMOVE, REMAFTER, DAYSMON, CALENDAR, MXREPEAT, OFF,       |
    | or FOR.                                                      |
    +--------------------------------------------------------------+
    +------ System Automation for z/OS Version 3 Release 5 --------+
    |PROGRAM NUMBER: 5698-SA3                                      |
    |TITLE:  End-to-End Automation Adapter           SC34-2750-00  |
    |                                                              |
    |Chapter 4. Installing the end-to-end automation adapter       |
    |Topic:     User-defined HFS                                   |
    |                                                              |
    |Change:                                                       |
    |                                                              |
    | Replace the first bullet                                     |
    |                                                              |
    | o the automation adapter master configuration file,          |
    |   ingadapter.properties                                      |
    |                                                              |
    | with the following:                                          |
    |                                                              |
    | o the automation adapter master configuration file,          |
    |   ing.adapter.properties                                     |
    |--------------------------------------------------------------|
    |Change:                                                       |
    |                                                              |
    | Further down in Figure 3. Sample environment variables,      |
    | ingadapter.properties, replace item  6                       |
    |                                                              |
    |   6  #JAVA_HOME=/local/java/a60/j6.0                         |
    |                                                              |
    | with the following:                                          |
    |                                                              |
    |  # @01A In order to run with different java runtime set      |
    |    E2E_JAVA_HOME                                             |
    |   6  #E2E_JAVA_HOME=/local/java/j6.0                         |
    +--------------------------------------------------------------+
    

APAR Information

  • APAR number

    OA46166

  • 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

    2014-10-01

  • Closed date

    2014-12-11

  • Last modified date

    2015-01-02

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

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

    UA75822 UA75823 UA75824 UA75825 UA75826 UA75827 UA75828

Modules/Macros

  • AOF#QRY  AOFAUTB  AOFD07   AOFEIZPD AOFFBAM1 AOFFBTMR AOFFCPTF
    AOFFCREL AOFFFPRO AOFFFTMX AOFFZTBL AOFH$TI  AOFHGN00 AOFHGPB0
    AOFJPDBI AOFJPDB3 AOFJPDFI AOFKATIR AOFPHTI1 AOFPITI1 AOFRAATB
    AOFRAAT1 AOFRACF0 AOFRACF7 AOFRSCHK AOFRSGST AOFSTMR  AOFTLP1
    AOF35    DSIING37 EVJRSACT EVJ07004 EVJ11001 EVJ12    HSAL110
    IHVICKH  IHVTFLTM ING#RDS  INGCMD   INGH$RU  INGMSGSA INGRCRDS
    INGRCRDX INGRCVAL INGREVTC INGREVTS INGRPLEX INGRVAM0 INGRVX27
    INGRWMTR INGRXTXP INGRXTX0 INGRX274 INGRX279 INGRYCMD INGRYCOM
    INGSAP   INGXE2E  INGXJAV2 INGXOPTE ING33    ING37
    

Publications Referenced
SC34265000SC34274800SC34272000SC34264800SC34271900
SC34275000SC34265100SC34274900SC34271700 

Fix information

  • Fixed component name

    SYSTEM AUTO Z/O

  • Fixed component ID

    5698SA300

Applicable component levels

  • R330 PSY UA75822

       UP14/12/18 P F412

  • R340 PSY UA75823

       UP14/12/18 P F412

  • R341 PSY UA75826

       UP14/12/18 P F412

  • R35D PSY UA75824

       UP14/12/18 P F412

  • R35F PSY UA75827

       UP14/12/18 P F412

  • R350 PSY UA75825

       UP14/12/18 P F412

  • R351 PSY UA75828

       UP14/12/18 P F412

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:
02 January 2015