PQ96526: EXTEND -DSCRIPT.ENCODING OPTION TO ACCOUNT FOR PROFILE FILE

 A fix is available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
Currently the -Dscript.encoding option applies only
to command script files (passed in via the -f option)
and not to profile script files.  This APAR will extend
the -Dscript.encoding option to account for profile file.
..
The customer will receive
WASX7017E: Exception com.ibm.bsf.BSFException:
error while eval'ing Jacl expression:missing close-brace
..
They only receive the error message when the profile is in
EBCDIC
When the customer change profile  to contains ASCII data
(by using 'iconv' to convert it) the process will work find.
Again this APAR will extend -Dscript.encoding option to account
for profile file.
..
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V5.0 for z/OS                                *
****************************************************************
* PROBLEM DESCRIPTION: Message WASX7017E seen when scripting   *
*                      profile files encoded in EBCDIC(Cp1047) *
*                      are used with the JVM option            *
*                      -Dscript.encoding in wsadmin.sh         *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The JVM option -Dscript.encoding only applies to command scripts
(Jacl or Jython) encoded in EBCDIC(Cp1047) on z/OS and not to
profile script files. If profile files are encoded in
EBCDIC(Cp1047), the following message is seen when executing
the wsadmin.sh script
WASX7017E: Exception com.ibm.bsf.BSFException:
error while eval'ing Jacl expression:missing close-brace
Problem conclusion
A new JVM option, -Dprofile.encoding=Cp1047, has been provided
to use with wsadmin.sh when scripting profile files are encoded
in EBCDIC(Cp1047)

APAR PQ96526 requires a  change to the InfoCenter. To access the
latest online documentation, go to the product library page at:

www.ibm.com/software/webservers/appserv/zos_os390/library/

The following text was added to InfoCenter article
txml_launchscript in the 'Running scripting
commands in a profile' section:

Note: WebSphere Application Server for z/OS supports multiple
encoding for Jacl and Jython profile scripts. The default
encoding for the profile file is ASCII. To run an EBCDIC
encoded profile script file, pass the following Java virtual
machine (JVM) argument to the wsadmin.sh file via the
-javaoption flag:
-Dprofile.encoding=Cp1047
For example:
wsadmin.sh -javaoption -Dprofile.encoding=Cp1047
You can alternatively create a new file called
wsadminE.sh, that references the EBCDIC version of the
profile file. For example, create a file called wsadminE.sh.
Place the following command in the wsadminE.sh file:
#!/bin/sh
wsadmin.sh -javaoption -Dprofile.encoding=Cp1047
        -profile profile_file.jacl
Note the wsadmin.sh command is split across 2 lines for
display purposes only and should be on a single line within
the wsadminE.sh file.

By default, the following profile files might be
configured for the com.ibm.ws.scripting.profiles
profiles property in the install_root/properties/
wsadmin.properties file:
install_root/bin/securityProcs.jacl
install_root/bin/LTPA_LDAPSecurityProcs.jacl
By default, these files are in ASCII. If you use the
profile.encoding option to run EBCDIC encoded profile
script files, change the encoding of the default profile
files to EBCDIC.

In the 'Running commands in a script'
section, the following changes were made:

To run an EBCDIC encoded Jacl file, pass
the following Java virtual machine (JVM) argument to
the wsadmin.sh file

was changed to:

To run an EBCDIC encoded Jacl file, pass the following
Java virtual machine (JVM) argument to the wsadmin.sh tool
via the -javaoption flag

Then add -Dscript.encoding=Cp1047 to the wsadmin.sh file.

was changed to:

Then add -Dscript.encoding=Cp1047 to the wsadminE.sh file.

The following sentences were added to this section:
You can alternatively create a new file called wsadminE.sh
file that references the EBCDIC version of the command file.
Place the following command in the wsadminE.sh file:
#!/bin/sh
wsadmin.sh  -javaoption -Dscript.encoding=Cp1047
         -f  command_file.jacl
Note the wsadmin.sh command is split across 2 lines for
display purposes only and should be on a single line within
the wsadminE.sh file.

APAR PQ96526 is associated with SERVICE LEVEL W502020 of
WebSphere Application Server V5.0 for z/OS.
Temporary fix Comments
APAR information
APAR number PQ96526
Reported component name WEBSPHERE FOR Z
Reported component ID 5655I3500
Reported release 500
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Special Attention NoSpecatt
Submitted date 2004-11-01
Closed date 2004-12-15
Last modified date 2005-01-05

APAR is sysrouted FROM one or more of the following:

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

Modules/Macros
BBOUBINF          

Publications Referenced

Fix information
Fixed component name WEBSPHERE FOR Z
Fixed component ID 5655I3500

Applicable component levels
R500 PSY UQ96100    UP04/12/21 P F412

  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


Current web document: swg1PQ96526.html
Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 500
Software edition:
Reference #: PQ96526
IBM Group: Software Group
Modified date: Jan 5, 2005