IBM Support

SI69451 - RDARS-INCORROUT Handle blank exit name in QRLMMONQ data area

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

RDARS-INCORROUT Handle blank exit name in QRLMMONQ data area


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED           PTF/FIX  LEVEL

TYPE PROGRAM  RELEASE   NUMBER   MIN/MAX  OPTION
---- -------- --------- -------  -------  ------
PRE  5770RD1  V7R3M0    SI65087   NONE     0000



NOTICE:
-------
Application of this PTF may disable or render ineffective programs that
use system memory addresses not generated by the IBM translator,
including programs that circumvent control technology designed to limit
interactive capacity to purchased levels.  This PTF may be a prerequisite
for future PTFs.  By applying this PTF you authorize and agree to the
foregoing.

This PTF is subject to the terms of the license agreement which
accompanied, or was contained in, the Program for which you are obtaining
the PTF.  You are not authorized to install or use the PTF except as part
of a Program for which you have a valid Proof of Entitlement.

SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS EXPLICITLY
AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN APPLICABLE SUPPORT
AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON INFRINGEMENT,
REGARDING THE PTF.

The applicable license agreement may have been provided to you in printed
form and/or may be viewed using the Work with Software Agreements (WRKSFWAGR)
CL command.


APAR Error Description / Circumvention

-------------------------------------------------
When a directory monitor is started by using the Start Monitor
(STRMONOND) command, and the QRLMMONEXT data area exists and
contains a blank value in the universal directory monitor exit
name field and a non-blank value in the universal output queue
monitor exit name field, the monitor will incorrectly try to
call the universal directory monitor exit.  The call fails with
message CPF0001 because the program name is blank.

The same problem exists for output queue monitors when the
QRLMMONEXT data area exists and contains a blank value in the
universal output queue monitor exit name field and a non-blank
value in the universal directory monitor exit name field.

CORRECTION FOR APAR 'SE70858' :
-------------------------------
The STRMONOND command has been corrected.  If the QRLMMONEXT
data area exists and contains a blank value in the universal
monitor exit name field that corresponds to the requested
monitor type, no attempt is made to call a universal monitor
exit, and attribute-specific monitor exit rules are followed.
The QRLMMONEXT data area can be placed in the instance library
or the QUSRRDARS library.  If it exists in both the instance
library and QUSRRDARS, the data area in the instance library is
used.

The Output queue (OUTQ), Error output queue (ERROUTQ), Processed
output queue (PRCOUTQ), and Directory (DIR) parameter values of
the STRMONOND command are now validated before the monitor is
started.  For output queue monitors, the specified output queues
must exist and different values must be used for each of the
OUTQ, ERROUTQ and PRCOUTQ parameter values.  For directory
monitors, the specified directory must exist, and the user must
have read, write and execute (*RWX) data authorities for that
directory.

A new keyword, Message logging (LOG), has been added to the
STRMONOND command.  The help for this keyword will be added in a
future release, and will read as follows:

Message logging (LOG) - Help

Specifies whether the monitor job sends detailed messages
to the job log.  This can be helpful when implementing a
new monitor to ensure that reports are loaded into the
expected application groups and applications according to
the specified parameters and monitor user exit programs.

*NO
Do not send detailed messages to the job log.
*YES
Send detailed messages to the job log.

CIRCUMVENTION FOR APAR 'SE70858' :
----------------------------------
None.


Activation Instructions

None.




Special Instructions

The use of the QRLMMONQ data area is being changed with this PTF.  Its
original purpose was to prevent unintended use of an ILE program in the
monitor's library list as an attribute-specific monitor exit.  However,
the library of the intended monitor exit can now be specified in
character positions 21 to 30 in the QRLMMONEXT data area.  This is a
more robust and flexible solution for ensuring the correct program is
used as a monitor exit.  Therefore, the QRLMMONQ data area will be
ignored if the QRLMMONEXT data area exists and the length of the
QRLMMONEXT data area is at least 30 characters.  If the QRLMMONEXT data
area does not exist, or exists with a length less than 30 characters,
the QRLMMONQ data area will continue to be used on existing IBM i
releases.  In a future release, the QRLMMONQ data area will be
deprecated entirely, so it is advised that current users of the
QRLMMONQ data area discontinue the use of that data area.  Instead,
specify the library of the intended monitor exit in character positions
21 to 30 in the QRLMMONEXT data area.  This change will ensure that the
correct program is used as a monitor exit.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI68997      RDARS-UNPRED CUSTOMER HAS IDENTIFIED UNQUALIFIED PROGRAM CAL
   SI67294      RDARS-INCORROUT OD MONITOR JOB GETS MSGCPFA0CF INTERMITTENTL
   SI66311      RDARS-ONDCSRV-INCORROUT MRGSPLFOND fails if printer file has
   SI65090      RDARS-ONDCSRV-INCORROUT Verify server has started for comman
   SI65090      RDARS-ONDCSRV-INCORROUT ADDRPTOND does not remove .ann or .a
   SI62934      RDARS-ONDCSRV-INCORROUT STRMONOND needs longer delay time wh
   SI58426      RDARS-ONDCSRV-INCORROUT Command QRYDOCOND ADDRPTID keyword d
   SI59423      RDARS-ONDCSRV Allow STRASMOND(*FORCE) on STRDSMOND
   SI63139      RDARS-ONDCSRV Support server trace via ADDRPTOND command

Summary Information

System..............................i
Models..............................
Release.............................V7R3M0
Licensed Program...............5770RD1
APAR Fixed..........................View details for APAR SE70858
Superseded by:......................View fix details for PTF SI73916
Recompile...........................N
Library.............................QRDARS
MRI Feature ........................NONE
Cum Level...........................C9311730


IBM i Support

IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3","Product":{"code":"SG15V","label":"PTF Cover Letters - IBM i General"},"Component":"5770RD1","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3","Product":{"code":"SG16H","label":"PTF Cover Letters - IBM i 7.3"},"Component":"5770RD1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
10 August 2020