PQ79815: INFOCENTER EXAMPLE FOR CREATING "J2CRESOURCEADAPTER" IS NOT CORRECT

APAR status
Closed as documentation error.

Error description
Creating "J2CresourceAdapter" from wscp
=======================================

1.As per 4.0.X infocenter

http://
www-3.ibm.com/software/webservers/appserv/doc/v40/ae/infocenter
/was/06060002020411.html#HDRWSCPEX-J2C

6.6.0.2.2.4.11: Administering EIS connections
---------------------------------------------
The following command example creates a J2C resource adapter.
The ArchiveFile attribute is required.

wscp> J2CResourceAdapter create /J2CResourceAdapter:ResAd/
-attributes {{ArchiveFile C:/apps/resources.rar}}

The following command example installs a J2C resource adapter.
The node and resource archive (RAR)file attributes are required.

wscp> J2CResourceAdapter install /J2CResourceAdapter:myRes/
-node /Node:Appserv1/ -rarfile "C:/apps/resources.rar"

The following command example creates a J2C connection factory
object.You must specify the name of the J2C resource adapter
with which the connection factory is associated with.
The optional attributes specify the timeout period in
milliseconds and the maximum number of connections supported
by that connection factory.

wscp> J2CConnectionFactory create
/J2CResourceAdapter:ResAd/J2CConnectionFactory:factory1/
-attributes {{ConnectionTimeout 1000} {MaxConnections 10}}
.
1.When we use above example we get following exception:

wscp> J2CResourceAdapter create /J2CResourceAdapter:KenKen/
-attributes {{ArchiveFile C:/WebSphere/40X/AppServer/admin.rar}}

WSCP0046E: Invalid option : -attributes
.
2.When we use online help for J2CResourceAdapter create
we get different information

wscp> J2CResourceAdapter help create
J2CResourceAdapter create <name> [-attribute <attribute list>]

*****

From this we understand that Infocenter information is
NOT correct and we need to use "-attribute" and NOT
"-attributes" (The difference is  "S" )
Local fix Problem summary
****************************************************************
* USERS AFFECTED: Users of WebSphere Application Server        *
*                 Version 4.0.x InfoCenter.                    *
****************************************************************
* PROBLEM DESCRIPTION: Section  6.6.0.2.2.4.11:                *
*                      Administering EIS connections of        *
*                      WebSphere Application Server Version    *
*                      4.0.x InfoCenter incorrectly            *
*                      documents a command example.            *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
 The command example in  section  6.6.0.2.2.4.11:
Administering EIS connections of WebSphere Application Server
Version 4.0.x InfoCenter states to use "-attributes". This is
not correct. The correct usage is "-attribute". The letter "s"
needs to be removed from the word attributes.
Problem conclusion
Close this APAR as a documentation change.
The updated information will be available to the
customers after 10/31/2003.
Temporary fix Comments
APAR information
APAR number PQ79815
Reported component name WEBSPHERE AE NT
Reported component ID 5630A2201
Reported release 400
Status CLOSED DOC
PE NoPE
HIPER NoHIPER
Submitted date 2003-10-20
Closed date 2003-10-23
Last modified date 2003-10-23

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros

Fix information

Applicable component levels


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > General
Operating system(s):
Software version: 400
Software edition:
Reference #: PQ79815
IBM Group: Software Group
Modified date: Oct 23, 2003