IBM Support

SI42403 - OSP-QDCRNWSD API returns incorrect virtual ethernet info

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP-QDCRNWSD API returns incorrect virtual ethernet info


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED      PTF/FIX  LEVEL

TYPE PROGRAM  REL  NUMBER   MIN/MAX  OPTION
---- -------- ---  -------  -------  ------
NONE



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

-----------------------------------------------
The QDCRNWSD API is returning incorrect information in the
NWSD0800 format.  Specifically the Number of virtual Ethernet
paths is set to 1 after the following scenario, even though
there are no paths configured.

The "Display Network Server Desc" panel also shows incorrect
text for the "Host adapter VE paths" when DSPNWSD NWSD(ADISCSI)
OPTION(*VRTETHPTH) or OPTION(*ALL) is specified.  The display
panel should show "(No host adapter VE paths)"

This was discovered using the following High Availability test
case.

Recreation Steps:

1.  On a 2 node cluster with an switchable IASP (named IASP001),
create an Admin Domain (AD) with no Monitored Resource Entries
(MREs) and start it.

2. Create a couple of NWSSTG objects on the local node and link
it to the switchable IASP IASP001.

CRTNWSSTG NWSSTG(ADISCSI1) ASPDEV(IASP001)

CRTNWSSTG NWSSTG(ADISCSI2) ASPDEV(IASP001)

3. Add the created NWSSTG to the ACTIVE AD:

ADDCADMRE RSCTYPE(*NWSSTG) RESOURCE(ADISCSI1) ATTRIBUTE(*ALL)
CLUSTER(TESTCLU) ADMDMN(ACRGAD)

4. Create an NWSD object with TYPE(*ISCSI *ESX) on the local
node via:

CRTNWSD NWSD(ADISCSI) RSRCNAME(*NONE) TYPE(*ISCSI *ESX)
STGPTH((BLAH)) DFTSECRULE(*NONE) MLTPTHGRP(*NONE) DFTSTGPTH(1)
RMVMEDPTH(1) ACTTMR(120) VRYWAIT(*NOWAIT) SHUTDTIMO(*TYPE)
CODEPAGE(850) MSGQ(*JOBLOG) CMNMSGQ(*SYSOPR)
TCPPORTCFG((*VRTETHPTP '1.2.3.4' '255.255.255.0'))
VRTETHPTH((*VRTETHPTP BLAHVIRT (1 1 1 1))) RSTDDEVRSC(*NONE)
NWSCFG(*DFT *DFT) VRTETHCTLP(8800) SYNCTIME(*NONE)
TEXT('WooHoo')

5. Add the created NWSD object with *ALL attributes to the
ACTIVE AD via ADDCADMRE.  The MRE should go consistent and admin
domain will create that object on the remote node.

6. Remove the NWSD object from the AD via RMVCADMRE.

7. On the local node, change the NWSD object via:

CHGNWSD NWSD(ADISCSI) VRTETHPTH((*NONE)) TCPPORTCFG((*NONE))

This could probably be recreated just by creating the NWSD and
then changing it, but the problem was discovered after trying to
add the NWSD back into the admin domain after step 7.  The AD
code ends up generating an invalid CHGNWSD command string based
on the bad data returned from the QDCRNWSD API.

CORRECTION FOR APAR SE46496 :
-----------------------------
The QDCRNWSD API was returning incorrect information for several
of the virtual Ethernet path fields.  DSPNWSD was also
displaying incorrect Virtual Ethernet path information.  The
CHGNWSD command was incorrectly modifying the *NWSD object.  The
QDCCHNWS module has been corrected.

Application of this PTF does not correct existing *NWSD objects.
The Change Network Server Desc (CHGNWSD) command with the
VRTETHPTH((*NONE)) parameter value must be issued after this PTF
is applied.  If the *NWSD object is still not correct, the
Delete Network Server Desc (DLTNWSD) command followed by the
Create Network Server Desc (CRTNWSD) command must be issued to
delete and recreate the object.

CIRCUMVENTION FOR APAR SE46496 :
--------------------------------
None.


DESCRIPTION OF PROBLEM FIXED FOR APAR SE47400 :
-----------------------------------------------
OSP-QDCRNWSD API returns incorrect Storage path number

The QDCRNWSD (Retrieve NWSD) API is returning incorrect
information in the NWSD0800 format when a network server storage
space is linked to more than one *NWSD object.  The QDCRNWSD API
returns 0 for the storage path number field.

Example that will cause problem:

ADDNWSSTGL NWSSTG(CEMESX1) NWSD(ESX1) ACCESS(*SHRUPD) followed
by

ADDNWSSTGL NWSSTG(CEMESX2) NWSD(ESX1) ACCESS(*SHRUPD)

Work around is have the network server storage space linked to
only one *NWSD object.

CORRECTION FOR APAR SE47400 :
-----------------------------
Module QDCRNWSD was fixed to return the correct storage path
number.

CIRCUMVENTION FOR APAR SE47400 :
--------------------------------
None.


Activation Instructions


None.




Special Instructions


None.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
     NONE

Summary Information

System..............................i
Models..............................
Release.............................V7R1M0
Licensed Program...............5770SS1
APAR Fixed..........................View details for APAR SE46496
View details for APAR SE47400
Superseded by:......................View fix details for PTF SI44234
Recompile...........................N
Library.............................QSYS
MRI Feature ........................NONE
Cum Level...........................C1270710


System 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 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.

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG15V","label":"PTF Cover Letters - OS\/400 General"},"Component":"","ARM Category":[],"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"V7R1M0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
19 April 2011