PK75331: SCRIPT LIBRARY FUNCTIONS DO NOT DOCUMENT THE RETURN VALUE IN THE HELP MESSAGES

Fixes are available

APAR status

Closed as program error.

Error description

The following problems are reported in this APAR:
1. The script library functions do not have documentation
about function return value. The user has to read the script
library or run it to figure out what the return value of the
function will contain.

2. The wsadmin install applications to dmgr by default if you do
not specify the target which is different from the console
(default is server1). The command syntax generated from the
command assistance window will not work in wsadmin.

3. AdminTask.applyConfigProperties fails on z/OS due to the
adjunt and server region properties are corrupted in the
property file after applied.

4. The ClassCastException is thrown when creating a dmgr
profile in z/OS.

5. AdminBLA.updateAsset command fails in batch mode when using
the generated script command from interactive mode when
command contains private parameters (hidden values)

Local fix

Problem summary

****************************************************************
* USERS AFFECTED:  All users of WebSphere Application Server   *
*                  V7.0                                        *
****************************************************************
* PROBLEM DESCRIPTION: Script library does not document        *
*                      return, Jython installs app to dmgr,    *
*                      AdminTask.applyConfigProperties fails   *
*                      on z/OS.                                *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The following problems are reported in this APAR:

1. The script library functions do not document return values.

2. The wsadmin installs applications to dmgr by default if
target is not specified (-node, -server or
-MapModulesToServers) that is different from the console
(default target is server1). The command syntax generated from
the command assistance will not work in wsadmin.  The command
assistance should generate -MapModulesToServers target mapping
data from the console regardless of whether you have or have
not changed the target information.

3. AdminTask.applyConfigProperties fails on z/OS because the
adjunct (adjunt_region_dynapplenv_jclparms) and server region
properties (server_region_dynapplenv_jclparms) are
corrupted in the property file after being applied.

4. Failed to create a dmgr profile with the ClassCastException

5. AdminBLA.updateAsset command fails in batch mode when using
the generated script command from command interactive mode
if command contains private parameters (hidden values).

Problem conclusion

The following problems are reported by this APAR:
1. Added the return value message in each script library help
message (scriptLibraryMessage) and script library function
comment.
2. Fixed AdminAppCommand command assistance code to always
generate -MapModulesToServers task data regardless of whether
the task is changed or not. The commandd assistance console
was also changed to send the -MapModulesToServer task
information to the AdminAppCommand to generate the command
syntax.
3. Fixed the ApplyProperties code to get the current server
attribute values from startCommandArgs.
4. Fixed the wsadmin MetaInfoCache code to avoid the
ClassCastException being thrown for "Boolean" config type.
5. Fixed the wsadmin AdminCmdController and
AdminCmdScriptGenerator code to add the missing private
parameter values back to the row list (the private parameter
values are skipped from command generated syntax) in order to
match with the original parameter list.

The fix for this APAR is currently targeted for inclusion in
fixpack 7.0.0.3.  Please refer to the Recommended Updates
page for delivery information:
http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980

Temporary fix

Comments

APAR Information

APAR number
PK75331
Reported component name
WEBSPHERE APP S
Reported component ID
5724J0800
Reported release
700
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2008-11-10
Closed date
2008-12-10
Last modified date
2009-02-25

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

Fix information

Fixed component name
WEBSPHERE APP S
Fixed component ID
5724J0800

Applicable component levels

R700 PSY
UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
23 October 2021

Tips

PK75331: SCRIPT LIBRARY FUNCTIONS DO NOT DOCUMENT THE RETURN VALUE IN THE HELP MESSAGES

Fixes are available

Subscribe

APAR status

Closed as program error.

Error description

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

APAR number

Reported component name

Reported component ID

Reported release

Status

PE

HIPER

Special Attention

Submitted date

Closed date

Last modified date

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Fix information

Fixed component name

Fixed component ID

Applicable component levels

R700 PSY

Document Information

Share your feedback

Need support?