A fix is available
APAR status
Closed as new function.
Error description
INGEXEC */SYS/* should not try to issue the command on systems where no Automation Agent is active.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All SA z/OS V3R3, V3R4 and V3R5 customers * * using the INGEXEC command. * **************************************************************** * PROBLEM DESCRIPTION: INGEXEC should only send commands to * * systems where an Automation Agent is * * active. * **************************************************************** * RECOMMENDATION: * **************************************************************** The INGEXEC command should verify that an Automation Agent is active before selecting a resource and a system where the specified command should be processed. If there is no Automation Agent active then the specified command cannot be processed successfully.
Problem conclusion
Temporary fix
Comments
REXX part INGRYEXE has been modified to verify that an Automation Agent is running on the system where the specified resource resides. Help panel ING#EXEC has been modified to explain the behavior. +------ System Automation for z/OS Version 3 Release 3 --------+ | | |PROGRAM NUMBER: 5698-SA3 | | | |TITLE: Programmer's Reference SC34-2576-02 | | | |Chapter 2. SA z/OS System Operations Commands | |Topic: INGEXEC | |Subtopic: Parameters | | | |Change: | |At the end of the description of parameter resource, change | |the 'Note' to 'Note1' and add the following 'Note2': | | | | Note2: ONLY resources where the SA z/OS automation agent is | | up and running are considered. | | | |--------------------------------------------------------------| | | |Subtopic: Examples | | | |Change: | |Replace this subtopic with the following: | | | | Examples | | | |Consider a setup with three basic DB2 application groups that | |each have three DB2 applications: DB2MSTR, DB2IRLM, and | |DB2DIST. All three applications in DB2GRP/APG/SYS1 are active,| |DB2DIST in DB2GRP/APG/SYS2, and all three applications in | |DB2GRP/APG/SYS3 are inactive. On all systems (SYS1-SYS3) the | |SA z/OS automation agent is running. | | | |Now consider the result of the following: | | | |1. INGEXEC DB2GRP/APG/* STATUS=ACTIVE SUBCAT=MSTR | | SELECT=ONE CMD='...' | | | | In this example, both DB2MSTR/APL/SYS1 and | | DB2MSTR/APL/SYS2 are selected. However, because SELECT=ONE| | is specified the command is denied. | | | |2. INGEXEC DB2/APG STATUS=ACTIVE SUBCAT=DIST SELECT=ALL | | RESP=NO CMD='...' | | | | In this example, DB2DIST/APL/SYS1 is selected. It is the | | only resource with subtype=DIST that is active. The | | command is routed to SYS1. Subsystem symbol (&SUBxxxxx) | | substitution takes place using the subsystem settings of | | DB2DIST on SYS1. Because RESP=NO is specified, SA z/OS | | does not wait for command completion. | | | |3. INGEXEC DB2MSTR SELECT=ALL CMD='...' | | | | In this example, the resources DB2MSTR/APL/SYS1, | | DB2MSTR/APL/SYS2 and DB2MSTR/APL/SYS3 are selected. The | | command is routed to SYS1, SYS2 and SYS3. Subsystem symbol| | (&SUBxxxxx) substitution takes place using the | | corresponding subsystem settings. | | | |To issue a command on all systems which are active in the | |SAplex (which means the SA z/OS automation agent is running), | |specify */SYS/* as the resource name, for example: | | | | ingexec */sys/* cmd='mvs d t' select=all | | | |The command output is collected and returned to the caller in | |one or more multi-line messages. There is one multi-line | |message for each command invocation on the target systems. The| |first line of the multi-line message describes: | | | |o The name of the system where the command executed | | | |o The name of the resource for which the command was | | executed | | | |o The return code of the command execution | | | |o The command itself | | | |Consider the following command running in an SAplex with SYS1,| |SYS2 and SYS3, but on SYS1 the SA z/OS automation agent is not| |active: | | | |INGEXEC TSO SELECT=FIRST,CMD='RES' | | | |The following is an example of the output of the command: | | | | | ING02 | | SYSTEM=SYS2 TSO/APL/SYS2 RC=0 CMD='RES' | | DSI386I NETVIEW RESOURCE UTILIZATION 14:38:37 | | TOTAL CPU % = 1.06 | | NETAROLI CPU % = 0.00 | | NETAROLI CPU TIME USED = 306.32 SEC. | | REAL STORAGE IN USE = 66948K | | PRIVATE ALLOCATED < 16M = 980K | | PRIVATE ALLOCATED > 16M = 66392K | | PRIVATE REGION < 16M = 9192K | | PRIVATE REGION > 16M = 307200K | | END OF DISPLAY | | | +--------------------------------------------------------------+ +------ 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: INGEXEC | |Subtopic: Parameters | | | |Change: | |At the end of the description of parameter resource, change | |the 'Note' to 'Note1' and add the following 'Note2': | | | | Note2: ONLY resources where the SA z/OS automation agent is | | up and running are considered. | | | |--------------------------------------------------------------| | | |Subtopic: Examples | | | |Change: | |Replace this subtopic with the following: | | | | Examples | | | |Consider a setup with three basic DB2 application groups that | |each have three DB2 applications: DB2MSTR, DB2IRLM, and | |DB2DIST. All three applications in DB2GRP/APG/SYS1 are active,| |DB2DIST in DB2GRP/APG/SYS2, and all three applications in | |DB2GRP/APG/SYS3 are inactive. On all systems (SYS1-SYS3) the | |SA z/OS automation agent is running. | | | |Now consider the result of the following: | | | |1. INGEXEC DB2GRP/APG/* STATUS=ACTIVE SUBCAT=MSTR | | SELECT=ONE CMD='...' | | | | In this example, both DB2MSTR/APL/SYS1 and | | DB2MSTR/APL/SYS2 are selected. However, because SELECT=ONE| | is specified the command is denied. | | | |2. INGEXEC DB2/APG STATUS=ACTIVE SUBCAT=DIST SELECT=ALL | | RESP=NO CMD='...' | | | | In this example, DB2DIST/APL/SYS1 is selected. It is the | | only resource with subtype=DIST that is active. The | | command is routed to SYS1. Subsystem symbol (&SUBxxxxx) | | substitution takes place using the subsystem settings of | | DB2DIST on SYS1. Because RESP=NO is specified, SA z/OS | | does not wait for command completion. | | | |3. INGEXEC DB2MSTR SELECT=ALL CMD='...' | | | | In this example, the resources DB2MSTR/APL/SYS1, | | DB2MSTR/APL/SYS2 and DB2MSTR/APL/SYS3 are selected. The | | command is routed to SYS1, SYS2 and SYS3. Subsystem symbol| | (&SUBxxxxx) substitution takes place using the | | corresponding subsystem settings. | | | |To issue a command on all systems which are active in the | |SAplex (which means the SA z/OS automation agent is running), | |specify */SYS/* as the resource name, for example: | | | | ingexec */sys/* cmd='mvs d t' select=all | | | |The command output is collected and returned to the caller in | |one or more multi-line messages. There is one multi-line | |message for each command invocation on the target systems. The| |first line of the multi-line message describes: | | | |o The name of the system where the command executed | | | |o The name of the resource for which the command was | | executed | | | |o The return code of the command execution | | | |o The command itself | | | |Consider the following command running in an SAplex with SYS1,| |SYS2 and SYS3, but on SYS1 the SA z/OS automation agent is not| |active: | | | |INGEXEC TSO SELECT=FIRST,CMD='RES' | | | |The following is an example of the output of the command: | | | | | ING02 | | SYSTEM=SYS2 TSO/APL/SYS2 RC=0 CMD='RES' | | DSI386I NETVIEW RESOURCE UTILIZATION 14:38:37 | | TOTAL CPU % = 1.06 | | NETAROLI CPU % = 0.00 | | NETAROLI CPU TIME USED = 306.32 SEC. | | REAL STORAGE IN USE = 66948K | | PRIVATE ALLOCATED < 16M = 980K | | PRIVATE ALLOCATED > 16M = 66392K | | PRIVATE REGION < 16M = 9192K | | PRIVATE REGION > 16M = 307200K | | END OF DISPLAY | +--------------------------------------------------------------+ +------ 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: INGEXEC | |Subtopic: Parameters | | | |Change: | |At the end of the description of parameter resource, change | |the 'Note' to 'Note1' and add the following 'Note2': | | | | Note2: ONLY resources where the SA z/OS automation agent is | | up and running are considered. | | | |--------------------------------------------------------------| | | |Subtopic: Examples | | | |Change: | |Replace this subtopic with the following: | | | | Examples | | | |Consider a setup with three basic DB2 application groups that | |each have three DB2 applications: DB2MSTR, DB2IRLM, and | |DB2DIST. All three applications in DB2GRP/APG/SYS1 are active,| |DB2DIST in DB2GRP/APG/SYS2, and all three applications in | |DB2GRP/APG/SYS3 are inactive. On all systems (SYS1-SYS3) the | |SA z/OS automation agent is running. | | | |Now consider the result of the following: | | | |1. INGEXEC DB2GRP/APG/* STATUS=ACTIVE SUBCAT=MSTR | | SELECT=ONE CMD='...' | | | | In this example, both DB2MSTR/APL/SYS1 and | | DB2MSTR/APL/SYS2 are selected. However, because SELECT=ONE| | is specified the command is denied. | | | |2. INGEXEC DB2/APG STATUS=ACTIVE SUBCAT=DIST SELECT=ALL | | RESP=NO CMD='...' | | | | In this example, DB2DIST/APL/SYS1 is selected. It is the | | only resource with subtype=DIST that is active. The | | command is routed to SYS1. Subsystem symbol (&SUBxxxxx) | | substitution takes place using the subsystem settings of | | DB2DIST on SYS1. Because RESP=NO is specified, SA z/OS | | does not wait for command completion. | | | |3. INGEXEC DB2MSTR SELECT=ALL CMD='...' | | | | In this example, the resources DB2MSTR/APL/SYS1, | | DB2MSTR/APL/SYS2 and DB2MSTR/APL/SYS3 are selected. The | | command is routed to SYS1, SYS2 and SYS3. Subsystem symbol| | (&SUBxxxxx) substitution takes place using the | | corresponding subsystem settings. | | | |To issue a command on all systems which are active in the | |SAplex (which means the SA z/OS automation agent is running), | |specify */SYS/* as the resource name, for example: | | | | ingexec */sys/* cmd='mvs d t' select=all | | | |The command output is collected and returned to the caller in | |one or more multi-line messages. There is one multi-line | |message for each command invocation on the target systems. The| |first line of the multi-line message describes: | | | |o The name of the system where the command executed | | | |o The name of the resource for which the command was | | executed | | | |o The return code of the command execution | | | |o The command itself | | | |Consider the following command running in an SAplex with SYS1,| |SYS2 and SYS3, but on SYS1 the SA z/OS automation agent is not| |active: | | | |INGEXEC TSO SELECT=FIRST,CMD='RES' | | | |The following is an example of the output of the command: | | | | | ING02 | | SYSTEM=SYS2 TSO/APL/SYS2 RC=0 CMD='RES' | | DSI386I NETVIEW RESOURCE UTILIZATION 14:38:37 | | TOTAL CPU % = 1.06 | | NETAROLI CPU % = 0.00 | | NETAROLI CPU TIME USED = 306.32 SEC. | | REAL STORAGE IN USE = 66948K | | PRIVATE ALLOCATED < 16M = 980K | | PRIVATE ALLOCATED > 16M = 66392K | | PRIVATE REGION < 16M = 9192K | | PRIVATE REGION > 16M = 307200K | | END OF DISPLAY | | | +--------------------------------------------------------------+
APAR Information
APAR number
OA46321
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-21
Closed date
2014-12-01
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:
UA75691 UA75693 UA75692 UA75694 UA75695 UA75696
Modules/Macros
ING#EXEC INGRYEXE
SC34257602 | SC34265000 | SC34274800 |
Fix information
Fixed component name
SYSTEM AUTO Z/O
Fixed component ID
5698SA300
Applicable component levels
R330 PSY UA75691
UP14/12/03 P F412
R331 PSY UA75692
UP14/12/03 P F412
R340 PSY UA75693
UP14/12/03 P F412
R341 PSY UA75695
UP14/12/03 P F412
R350 PSY UA75694
UP14/12/03 P F412
R351 PSY UA75696
UP14/12/03 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