OA54684: SMALL ENHANCEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  Change comand 'NETVASIS PIPE CC LIST STATUS=CANZLOG...' in
  GDPS_SYSTEM_SHUTDOWN entry of AOFJPDBD to avoid
  CNM421I COMMAND LIST ACFCMD - INVALID COMMAND NETVASIS
  ENCOUNTERED
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All SA z/OS V3R5 and V4R1 customers.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: see description below...                *
  ****************************************************************
  SA 3.5 and SA 4.1:
  o E2E adapter installation:
  System symbols will be supported for configuration files
  ing.adapter.properties and ing.adapter.plugin.properties.
  o E2E automation of resources on non-z/OS systems:
  INGLIST supports status updates to reset non-z/OS resources
  directly on the remote domain from non-recoverable-error.
  
  SA 4.1:
  o Invoking The Customization Dialogs twice from within the same
  session can result in message
  Error running INGDLG2, line 49: Bad arithmetic conversion
  o *GDPS add-on policy has a command with incorrect syntax in
  MVC entry GDPS_SYSTEM_SHUTDOWN. The command results in message
  CNM421I COMMAND LIST ACFCMD - INVALID COMMAND NETVASIS
  ENCOUNTERED
  o *GDPS add-on policy has a typo in AOP GDPS_ALL_AUTOOPS:
  automated function CEOBAT1 should be GEOBAT1.
  o New Automation Operator Definitions GEOOPER8/AUTOPER8 and
  GEOOPER9/AUTOPER9 added to policies *GDPS and *HYPERSWAP.
  o Added message IEA253I to and deleted message ANTQ8050I from
  sample INGMSGUG.
  o A MakeAvailable relationship for supporting resource OMVS was
  added to application SYSVSSI in add-on policy *BASE.
  o The start command for SYSLOGD was updated in add-on policy
  *BASE.
  o The *E2E add-on policy was enhanced to
    ensure the correct ASID for E2E Adapter and E2E Agent;
    ensure the correct restart of E2E Agent after AM recycle.
  o For customers using *SAPSRV:
    - AT override for BPXF024I is moved from +SA_PREDEFINED_MSGS
    to *SAPSRV into an APL class C_SAP_USS.
    - Update of BPXF024I message automation in NetView Automation
    Table for SAP. The 'Monitoring History' of the Enqueue Monitor
    Resource is now storing also the 2nd line of the message
    output, which holds the important words 'started' or
    'stopped'. It looks like this now:
      2018-04-25 13:05:33  -  ACTIVE         HEALTH=WARNING
      BPXF024I (HA1ADM) SAP system HA1 instance ASCS10 enqueue
               replication stopped
    - REXX utility SAPMVCF is part of ING_sap.tar.
    It can be used to detect and resolve a co-location situation
    of SAP Enqueue server and its Coupling Facility Replication
    data.
    - Updates of sap_os390_cluster_connector.rex and
    sap_os390_cluster_connector.sh: Added in help output that
    smm function works starting with SA 4.1.
  o The Logic Deck has been modified to allow the setting of the
  HOLD flag for REF resources.
  o SMFID is now correctly displayed on the SMU user interface for
  each system even when the XCF group id is not specified in
  INGXINIT.
  o TCP/IP hostname and IP address is now displayed on the
  SMU user interface for each system.
  

Problem conclusion

Temporary fix

Comments

• Changes have been made to implement the enhancements listed
  above.
  
  Added a new topic "Self-Terminating the End-to-End Agent":
  https://ibm.biz/BdYUKF
  
  Added return code 236 to ING377I: https://ibm.biz/BdYUKE
  
  The E2E automation adapter now supports system symbols.
  o The Automation Adapter Master Configuration File:
    https://ibm.biz/BdYUKj
  
  o The Automation Adapter Plug-in Configuration file:
    https://ibm.biz/BdYUKY
  
  Added new EEZA0005I message: https://ibm.biz/BdYUKq
  
  Added SetTarget, an E2E automation request name:
  https://ibm.biz/BdYUKP
  
  Refined AOF350E message: https://ibm.biz/BdYUKp
  
  This only applies to customers using BPXF024I, typically users
  of SAP Automation.
  
  Import APL class C_SAP_USS from *SAPSRV add-on policy and use
  the delivered definitions for BPXF024I.
  Alternatively, add BPXF024I to your policy with the AT override
  documented in the APAR closing comments.
  
  * SAP Enq.Replication started or stopped
  IF TOKEN(3) = 'SAP' & TOKEN(4) = 'system'
  & TOKEN(6) = 'instance' & TOKEN(8) = 'enqueue'
  & TOKEN(9) = 'replication' & TOKEN(5) = SAPSID THEN BEGIN;
    IF TOKEN(7) = 'ASCS' . THEN BEGIN;
     IF ACQUIRE('FINDLINE /star/ W 1.1 LEFT 7') = 'started' . THEN
        EXEC(CMD('PIPE SAFE * | SEP | JOINCONT // / / | EDIT
        /INGMON SAP'SAPSID'AEN MSGTYPE=SAPEROK STATUS=NORMAL
       INFO="/ 1 1.* N /"/ N | CHANGE /started*/started/ | NETV')
       ROUTE(ONE %AOFOPGSSOPER%));
      IF ACQUIRE('FINDLINE /sto/ W 1.1 LEFT 7') = 'stopped' . THEN
        EXEC(CMD('PIPE SAFE * | SEP | JOINCONT // / / | EDIT
       /INGMON SAP'SAPSID'AEN MSGTYPE=SAPERNOK STATUS=WARNING
       INFO="/ 1 1.* N /"/ N | CHANGE /stopped*/stopped/ | NETV')
       ROUTE(ONE %AOFOPGSSOPER%));
    END;
    IF TOKEN(7) = 'SCS' . THEN BEGIN;
     IF ACQUIRE('FINDLINE /star/ W 1.1 LEFT 7') = 'started' . THEN
        EXEC(CMD('PIPE SAFE * | SEP | JOINCONT // / / | EDIT
       /INGMON SAP'SAPSID'JEN MSGTYPE=SAPEROK STATUS=NORMAL
       INFO="/ 1 1.* N /"/ N | CHANGE /started*/started/ | NETV')
  

APAR Information

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

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

  UA97989 UA97990 UA97991 UA97992 UA97993 UA97994

Modules/Macros

• AOFAUTB  AOFFCPDB AOFFCPTF AOFFCREL AOFHELPS AOFJPDBC AOFJPDBD
  AOFJPDBE AOFJPDBF AOFJPDBG AOFJPDBH AOFJPDBI AOFJPDBZ AOFJPDB1
  AOFJPDB2 AOFJPDB3 AOFJPDB6 AOFJPDB7 AOFJPDB8 AOFJPDB9 AOFRATHR
  AOFRCAPM AOFRRRES AOFRSCMD AOFRSGAC AOFRSGCR AOFRSGHM AOFRSGTM
  AOFRSRPY AOFRUPDT AOFT0MSA AOFT0MSX AOF35    EEZA000  EVEERTRN
  EVEES100 EVIECT0X EVISTRCT ING#E2E  ING#E2E2 INGCMD   INGDLG2
  INGEEZAD INGEEZAM INGEEZSD INGEEZUT INGH$E2E INGKE2E2 INGLOGIC
  INGMSGUG INGRDSTS INGRDTTH INGRE2E  INGRE2E2 INGROMLS INGRXTXP
  INGRXTX0 INGRX400 INGRYST0 INGRYST1 INGSAP   INGXE2E  INGXFWRK
  INGXPLGA INGXPLGN INGXSYSV INGXUTIL ING37
  

Fix information

• Fixed component name

  SYSTEM AUTO Z/O

• Fixed component ID

  5698SA300

Applicable component levels

• R35F PSY UA97991

     UP18/11/22 P F811

• R350 PSY UA97989

     UP18/11/22 P F811

• R351 PSY UA97992

     UP18/11/22 P F811

• R41F PSY UA97993

     UP18/11/22 P F811

• R410 PSY UA97990

     UP18/11/22 P F811

• R411 PSY UA97994

     UP18/11/22 P F811

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.