A fix is available
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
SC34265000 | SC34274800 | SC34272000 | SC34264800 | SC34271900 |
SC34275000 | SC34265100 | SC34274900 | SC34271700 |
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