PQ54283: SM-API LISTSERVERINSTANCE DOESN'T RETURN ENVIRONMENT

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
When using the following the 'environment' data is not returned:
rc =CB390CFG("-action 'listserverinstance' -xmlinput
 'inputlistserverinstance.xml' -input 'tempin' -output
 'listserverinstance1'")
-----------------------------
The SM Scripting does not return the correct output.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0 for z/OS and OS/390.                    *
****************************************************************
* PROBLEM DESCRIPTION: SM API LISTSERVERINSTANCE does          *
*                      return environment data.                *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
When using the following, the 'environment' data is not
returned:

  CB390CFG("-action 'listserverinstance' -xmlinput
 'inputlistserverinstance.xml' -input 'tempin' -output
 'listserverinstance1'")

SM API support will not return correct environment variables.
This will have no impact for the script and its functionality.
Only the environment variables are not displayed.
Problem conclusion
SM API support has been modified to return correct environment
variables.

The following publication was revised as a result
of APAR PQ54283:
________________________________________________________________

WebSphere Application Server V4.0 for z/OS and OS/390

System Management Scripting API
SA22-7839-00
________________________________________________________________

This APAR requires changes to documentation.

NOTE: Periodically, we refresh the documentation on our
Web site, so the changes might have been made before you
read this text. To access the latest on-line
documentation, go to the product library page at:

http://www.ibm.com/software/webservers/appserv/
________________________________________________________________

Chapter 4, pg. 99 (changed section)

Server Instances
These functions are for the modification of a server instance.
They can be performed on a server as well as a J2EE server.
________________________________________________________________

Chapter 4, pg. 101 (changed section)

output
The output file contains further information. There is an
example output file in the description of each serverinstance
action. The general output format for a serverinstance action
looks like this:
administratorname.1 AdministratorName
configportnumber.1 ConfiguredPortNumber
conversationname.1 ConversationName
logstreamname.1 LogstreamName
serverinstancedescription.1 ServerInstanceDescription
serverinstancename.1 ServerInstanceName
servername.1 ServerName
sslfirewallport.1 SSLFirewallPortNumber
sysplexname.1 SysplexName
systemname.1 SystemName
environment.1 EnvironmentVariables
status 0|4
message.1 OK|ErrorMessage
count NumberOfListedServerInstances
________________________________________________________________

Chapter 4, pg. 102 (changed section)

| ...        | ...                                             |
----------------------------------------------------------------
| servername | Name of the server or J2EE server               |
----------------------------------------------------------------
| ...        | ...                                             |
________________________________________________________________

Chapter 4, pg. 103 (changed section)

| ...              | ...                                       |
----------------------------------------------------------------
| configportnumber | Numeric value between 0 and 65535         |
|                  | Note: The Parameter name                  |
|                  | 'configportnumber' in the EUI is called   |
|                  | 'IIOP Firewall port'.                     |
----------------------------------------------------------------
| ...              | ...                                       |
________________________________________________________________

Chapter 4, pg. 103 (changed section)

| ...             | ...                                        |
----------------------------------------------------------------
| sslfirewallport | ...                                        |
----------------------------------------------------------------
| environment     | ...                                        |
----------------------------------------------------------------
________________________________________________________________

Chapter 4, pg. 104 (changed section)

output
The output file may look like this:
administratorname.1 CBADMIN
configportnumber.1 12345
conversationname.1 API Functiontest
logstreamname.1
serverinstancedescription.1 API Fucntiontest ServerInstance
serverinstancename.1 APIFCTSI
servername.1 APIFCT
sslfirewallport.1 9000
sysplexname.1 PLEX1
systemname.1 SY1
environment.1 CLASSPATH = 'test1' PATH = 'test2'
status 0
message.1 OK
count 1
________________________________________________________________

Chapter 4, pg. 106 (changed section)

| ...        | ...                                             |
----------------------------------------------------------------
| servername | Name of the server or J2EE server               |
----------------------------------------------------------------
| ...        | ...                                             |
________________________________________________________________
Chapter 4, pg. 107 (changed section)
output
The output file may look like this:
administratorname.1 CBADMIN
configportnumber.1 50000
conversationname.1 API Functiontest
logstreamname.1
serverinstancedescription.1 API Functiontest Server instance
Description modified
serverinstancename.1 APIFCTSI
servername.1 APIFCT
sslfirewallport.1 11000
sysplexname.1 PLEX1
systemname.1 SY1
environment.1 CLASSPATH = 'testchange1' PATH = 'testchange2'
status 0
message.1 OK
count 1
________________________________________________________________

Chapter 4, pg. 108 (changed section)

| ...              | ...                                       |
----------------------------------------------------------------
| servername       | Name of the server or J2EE server         |
----------------------------------------------------------------
| ...              | ...                                       |
----------------------------------------------------------------
| environment      | ...                                       |
---------------------------------------------------------------|
| configportnumber | Numeric value between 0 and 65535         |
|                  | Note: The Parameter name                  |
|                  | 'configportnumber' in the EUI is called   |
|                  | 'IIOP Firewall port'.                     |
----------------------------------------------------------------
| ...              | ...                                       |
----------------------------------------------------------------
________________________________________________________________
Chapter 4, pg. 109 (changed section)

| ...             | ...                                        |
----------------------------------------------------------------
| sslfirewallport | ...                                        |
----------------------------------------------------------------
________________________________________________________________

Chapter 4, pg. 110 (changed section)

output
The output file may look like this:
administratorname.1 CBADMIN
configportnumber.1 50000
conversationname.1 API Functiontest
logstreamname.1
serverinstancedescription.1 API Fucntiontest Serverinstance
Description modified
serverinstancename.1 APIFCTSI
servername.1 APIFCT
sslfirewallport.1 11000
sysplexname.1 PLEX1
systemname.1 SY1
environment.1 CLASSPATH = 'test1change' PATH = 'test2change'
status 0
message.1 OK
count 1
________________________________________________________________
Chapter 4, pg. 111 (changed section)
| ...        | ...                                             |
----------------------------------------------------------------
| servername | Name of the server or J2EE server               |
----------------------------------------------------------------
| ...        | ...                                             |
________________________________________________________________

Chapter 4, pg. 112 (changed section)

output
The output file may look like this:
administratorname.1 CBADMIN
configportnumber.1 50000
conversationname.1 API Functiontest
logstreamname.1
serverinstancedescription.1 API Functiontest Server instance
Description modified
serverinstancename.1 APIFCTSI
servername.1 APIFCT
sslfirewallport.1 11000
sysplexname.1 PLEX1
systemname.1 SY1
environment.1 CLASSPATH = 'testchange1' PATH = 'testchange2'
status 0
message.1 OK
count 1
________________________________________________________________
APAR PQ54283 is associated with SERVICE LEVEL W400057 of
WebSphere Application Server V4.0 for z/OS and OS/390.
Temporary fix Comments
APAR information
APAR number PQ54283
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 400
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2001-11-02
Closed date 2002-01-15
Last modified date 2002-02-02

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:
UQ61981

Modules/Macros
BBOUBINF BBOZ0688 BBOZ0813 BBOZ0814    

Fix information
Fixed component name WASKBASE
Fixed component ID 5655A9801

Applicable component levels
R400 PSY UQ61981    UP02/01/30 P F201

  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.


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 400
Software edition:
Reference #: PQ54283
IBM Group: Software Group
Modified date: Feb 2, 2002