A fix is available
APAR status
Closed as new function.
Error description
Small Enhancements . INGCLEAN issues AOF131I MISSING OR INVALID PARAMETER when called as an environment exit.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All SA z/OS V3R5 and V4R1 customers. * **************************************************************** * PROBLEM DESCRIPTION: see description below... * **************************************************************** * RECOMMENDATION: * **************************************************************** SA 3.5 and SA 4.1: o The *GDPS add-on policy has been enhanced to add auto operators GEOXRA15-GEOXRA20 and GEOXRQ15-GEOXRQ20 to AOP GDPS_XRC_AUTOOPS. o When appropriate, specify RNL=NO to avoid having the request incorrectly altered by the GRS or alternate serialization product RNL processing. o Several Customization Dialog help panels have been enhanced to avoid an ISPF Dialog Error when trying to enter 'F' for 'Find' in the panel's Command line. The same error can happen when any other character is typed in, followed by the ENTER key. o Enhance RESYNC SDF processing to also clear all ProcOps components. o Enhance message receiving in SDF. When SDF processes tree and panel definitions it issues a message for every INCLUDE member that cannot be found. The message is now returned to the user who caused SDF to process the definitions. o Several SA panels have been enhanced to display as much information as the panel size in use allows for. Also, where appropriate, the panel header now shows the SAplex name instead of the physical sysplex name. o Help panels ING#$QRY and ING#QRY have been enhanced to clarify where parent information is derived from. SA 4.1: o INGCLEAN was modified to enforce RESYNC SDF to also delete data in SDF and to accept input parameters when called as an environment exit. o Enhance CICS Automation Message Exit debugging. o Enhance INGSTR command and INGSTR display with structure type information. o Help panels ING#$QRY and ING#QRY have been enhanced with the SUSPEND attribute.
Problem conclusion
Temporary fix
Comments
Changes have been made to implement the enhancements listed above. +------ System Automation for z/OS Version 3 Release 5 --------+ |PROGRAM NUMBER: 5698-SA4 | |TITLE: System Automation for z/OS SC34-2720-00 | | Operator's Commands | |CHAPTER: Chapter 4. System Operations Commands | |TOPIC: INGCF | |CHANGE: marked with '#' | | Syntax | | >>--INGCF------------------------------------------------> | | >--.---------------------------------------------------.-> | | |-Drain--| cfname |---------------------------------| | | ... | | >--.-------------------------.--.---------------------.->< | | '-TARGET=-.-system_name-.-' '-OUTMODE=-.-LINE---.-' | | |-domain_ID---| |-AUTO---| | | # '-saplex_name-' '-NETLOG-' | |--------------------------------------------------------------| |CHAPTER: Chapter 4. System Operations Commands | |TOPIC: INGPLEX | |ADD: marked with '+' | |CHANGE: marked with '#' | | Syntax | | >>--INGPLEX----------------------------------------------> | | >-.---------------------------------------------------.--> | | '-.-CDS--.--------------------------------------.-.-' | | | '-TYPE=-.-ARM-----.--.--------------.--' | | | ... | | |-SLIP--.-----------.--.----------------.-------| | | | '-ID=slipid-' '-SYSTEM=sysname-' | | | + | (4) | | | + |-STR-------------------------------------------| | | |-SVCdump--.--------------------------------.---| | | | '-sysname--.-------------------.-' | | | | | (3) .-LIST-. | | | | | '-REQ---=-+-COMP-+--' | | | | '-DUMP-' | | | '-SYStem----------------------------------------' | | | | >-.-------------------------.--.---------------------.-->< | | '-TARGET=-.-system_name-.-' '-OUTMODE=-.-LINE---.-' | | |-domain_ID---| |-AUTO---| | | # '-saplex_name-' '-NETLOG-' | | IPLRECD: | | |--sysname/timestamp-------------------------------------| | | | | IPLREC: | | |--sysname/timestamp<</member<</suffix>>>>---------------| | | Notes: | | (1) For details see "INGCF" in IBM System Automation... | | ... | | + (4) For details see "INGSTR" in IBM System Automation for | | z/OS Operator's Commands. | | | | Parameters | | : | | + STR | | + This is the equivalent of the INGSTR command. | | SVCdump | | Allows you to issue a multisystem dump of up to 15... | |--------------------------------------------------------------| |CHAPTER: Chapter 4. System Operations Commands | |TOPIC: INGSTR | |CHANGE: marked with '#' | | Syntax | | >>--INGSTR--.--------------.--.--------------------.-----> | | '-strname<<*>>-' '-CONDition=-.-No--.-' | | | | >--.-------------------------.--.--------------.-------->< | | '-TARGET=-.-system_name-.-' '-OUTMODE=LINE-' | | |-domain_ID---| | | # '-saplex_name-' | +--------------------------------------------------------------+ +------ System Automation for z/OS Version 3 Release 5 --------+ |PROGRAM NUMBER: 5698-SA4 | |TITLE: System Automation for z/OS SC34-2748-00 | | Programmer's Reference | |CHAPTER: Chapter 4. SA z/OS REXX Functions | |TOPIC: INGENQ | |CHANGE: under parameter 'major' replace the existing Note | | with the following text: | | Note: | | 1. The wildcard, for example, "ABC*", is not recognized and | | it is treated as a normal character. | | 2. Do not mix ENQ scope SYSTEM and SYSTEMS requests that use | | the same major and minor. This is required due to RNL=NO | | parameter. | | | |CHANGE: under parameter 'minor' replace the existing Note | | with the following text: | | Note: | | 1. The wildcard, for example, "ABC*", is not recognized and | | it is treated as a normal character. | | 2. Do not mix ENQ scope SYSTEM and SYSTEMS requests that use | | the same major and minor. This is required due to RNL=NO | | parameter. | |--------------------------------------------------------------| |CHAPTER: Chapter 4. SA z/OS REXX Functions | |TOPIC: ING$QRY | |CHANGE: replace the text under parameter 'PARENT' with the | | following: | | Returns the parent information for the resource. Parent | | information is derived from each relationship that has | | a sequence number assigned to it. | |--------------------------------------------------------------| |CHAPTER: Chapter 2. SA z/OS System Operations Commands | |TOPIC: INGQRY | |CHANGE: replace the text under parameter 'PARENT' with the | | following: | | Returns the parent information for the resource. Parent | | information is derived from each relationship that has | | a sequence number assigned to it. | +--------------------------------------------------------------+ +------ System Automation for z/OS Version 4 Release 1 --------+ |PROGRAM NUMBER: 5698-SA4 | |TITLE: System Automation for z/OS SC34-2720-01 | | Operator's Commands | |CHAPTER: Chapter 4. System Operations Commands | |TOPIC: INGCF | |CHANGE: marked with '#' | | Syntax | | >>--INGCF------------------------------------------------> | | >--.---------------------------------------------------.-> | | |-Drain--| cfname |---------------------------------| | | ... | | >--.-------------------------.--.---------------------.->< | | '-TARGET=-.-system_name-.-' '-OUTMODE=-.-LINE---.-' | | |-domain_ID---| |-AUTO---| | | # '-saplex_name-' '-NETLOG-' | |--------------------------------------------------------------| |CHAPTER: Chapter 4. System Operations Commands | |TOPIC: INGPLEX | | | |ADD: marked with '+' | |CHANGE: marked with '#' | | Syntax | | >>--INGPLEX----------------------------------------------> | | >-.---------------------------------------------------.--> | | '-.-CDS--.--------------------------------------.-.-' | | | '-TYPE=-.-ARM-----.--.--------------.--' | | | ... | | |-SLIP--.-----------.--.----------------.-------| | | | '-ID=slipid-' '-SYSTEM=sysname-' | | | + | (4) | | | + |-STR-------------------------------------------| | | |-SVCdump--.--------------------------------.---| | | | '-sysname--.-------------------.-' | | | | | (3) .-LIST-. | | | | | '-REQ---=-+-COMP-+--' | | | | '-DUMP-' | | | '-SYStem----------------------------------------' | | | | >-.-------------------------.--.---------------------.-->< | | '-TARGET=-.-system_name-.-' '-OUTMODE=-.-LINE---.-' | | |-domain_ID---| |-AUTO---| | | # '-saplex_name-' '-NETLOG-' | | | | IPLRECD: | | |--sysname/timestamp-------------------------------------| | | | | IPLREC: | | |--sysname/timestamp<</member<</suffix>>>>---------------| | | | | Notes: | | (1) For details see "INGCF" in IBM System Automation... | | ... | | + (4) For details see "INGSTR" in IBM System Automation for | | z/OS Operator's Commands. | | | | Parameters | | : | | + STR | | + This is the equivalent of the INGSTR command. | | | | SVCdump | | Allows you to issue a multisystem dump of up to 15... | |--------------------------------------------------------------| |CHAPTER: Chapter 4. System Operations Commands | |TOPIC: INGSTR | | | |ADD: marked with '+' | |CHANGE: marked with '#' | | | | Syntax | | >>--INGSTR--.--------------.--.--------------------.-----> | | '-strname<<*>>-' '-CONDition=-.-No--.-' | | '-Yes-' | | # >--.--------------.--.-----------------.-----------------> | | # '-ALL=-.-No--.-' | .-- < --. | | | # '-Yes-' '-TYPE=-'-.-C-.-'-' | | # |-K-| | | # |-L-| | | # '-S-' | | >--.-------------------------.--.--------------.-------->< | | '-TARGET=-.-system_name-.-' '-OUTMODE=LINE-' | | |-domain_ID---| | | # '-saplex_name-' | | | | Parameters | | strname<<*>> | | Specifies a name pattern that limits the display. The | | default is to show all structures that match the 'ALL' | | condition. | | CONDition | | Defines whether or not the rebuild condition of each | | structure is to be determined and displayed. | | ALL | | Defines whether allocated and unallocated structures | | or just allocated structures are displayed. | | + TYPE | | + Defines what type of structures are to be displayed: | | + | | + C - cache | | + K - lock | | + L - list | | + S - serialized list | | + | | + (Default: all) | | TARGET | | For information on the TARGET parameter, see IBM | | System Automation for z/OS Operator's Commands. | +--------------------------------------------------------------+ +------ System Automation for z/OS Version 4 Release 1 --------+ |PROGRAM NUMBER: 5698-SA4 | |TITLE: System Automation for z/OS SC34-2748-01 | | Programmer's Reference | |CHAPTER: Chapter 4. SA z/OS REXX Functions | |TOPIC: INGENQ | | | |CHANGE: under parameter 'major' replace the existing Note | | with the following text: | | Note: | | 1. The wildcard, for example, "ABC*", is not recognized and | | it is treated as a normal character. | | 2. Do not mix ENQ scope SYSTEM and SYSTEMS requests that use | | the same major and minor. This is required due to RNL=NO | | parameter. | | | |CHANGE: under parameter 'minor' replace the existing Note | | with the following text: | | Note: | | 1. The wildcard, for example, "ABC*", is not recognized and | | it is treated as a normal character. | | 2. Do not mix ENQ scope SYSTEM and SYSTEMS requests that use | | the same major and minor. This is required due to RNL=NO | | parameter. | |--------------------------------------------------------------| |CHAPTER: Chapter 4. SA z/OS REXX Functions | |TOPIC: ING$QRY | | | |CHANGE: replace the text under parameter 'PARENT' with the | | following: | | Returns the parent information for the resource. Parent | | information is derived from each relationship that has | | a sequence number assigned to it. | | | |CHANGE: insert the following new parameter after 'SUBID': | | SUSPEND | | Returns DIRECT or INDIRECT if the resource is suspended. | |--------------------------------------------------------------| |CHAPTER: Chapter 2. SA z/OS System Operations Commands | |TOPIC: INGQRY | | | |CHANGE: replace the text under parameter 'PARENT' with the | | following: | | Returns the parent information for the resource. Parent | | information is derived from each relationship that has | | a sequence number assigned to it. | | | | | |CHANGE: insert the following new parameter after 'SUBID': | | SUSPEND | | Returns DIRECT or INDIRECT if the resource is suspended. | |--------------------------------------------------------------| |CHAPTER: Chapter 2. SA z/OS System Operations Commands | |TOPIC: AOCQRY | | | |CHANGE: In Table 4. AOCQRY Subsystem Task Global Variables, | | replace the description of Task Global Variable | | SUBSSUSPEND with the following text: | | This task global variable returns DIRECT or INDIRECT if the | | resource is suspended. | | | |CHANGE: In Table 4. AOCQRY Subsystem Task Global Variables, | | replace the description of Task Global Variable | | SUBPSUSPEND with the following text: | | This task global variable returns DIRECT or INDIRECT if the | | parent is suspended. | +--------------------------------------------------------------+
APAR Information
APAR number
OA52425
Reported component name
SYSTEM AUTO Z/O
Reported component ID
5698SA300
Reported release
350
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-03-29
Closed date
2017-07-14
Last modified date
2017-08-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA92722 UA92723 UA92724 UA92725 UA92726 UA92727 UA92728 UA92729
Modules/Macros
AOF#QRY AOFDBDSK AOFDMCSC AOFDMDDF AOFDMTRE AOFD00 AOFFTADV AOFFZENQ AOFGIMP3 AOFGREF1 AOFH$DIS AOFHAD ***This field was truncated. To obtain the full apar record, please contact your local support center.***
| SC34272000 | SC34274800 | SC34272001 | SC34274801 |
Fix information
Fixed component name
SYSTEM AUTO Z/O
Fixed component ID
5698SA300
Applicable component levels
R35F PSY UA92724
UP17/07/21 P F707
R350 PSY UA92722
UP17/07/21 P F707
R351 PSY UA92725
UP17/07/21 P F707
R41C PSY UA92726
UP17/07/21 P F707
R41F PSY UA92727
UP17/07/21 P F707
R41I PSY UA92728
UP17/07/21 P F707
R410 PSY UA92723
UP17/07/21 P F707
R411 PSY UA92729
UP17/07/21 P F707
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":"350","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
01 August 2017