Troubleshooting
Problem
IBM i Access for Web commands like CFGACCWEB may fail with indications that the parameters are not recognized.
Symptom
IBM i Access for Web commands like CFGACCWEB don't post an error, though the specified configuration is not done.
Cause
The issue was caused because the -appsvrtype parameter was not being recognized. This is because the underlying QShell Script utilizes a QShell mechanism of 'declare -u' to set a variable for the parameter. The -u is supposed to uppercase the characters so then the rest of the script is comparing against all uppercase values. Investigation showed that the -u uppercasing was not working as it should and the variable still contained lowercase characters.
The root cause of this behavior was that there was a mis-match between the CCSID and Locale environment. The CCSID was 1399 and the Locale was set to JA_JP.LOCALE. The JA_JP.LOCALE is basically the same as JA_JP_5026.LOCALE. So, when Qshell attempts to uppercase the characters there isn't a valid mapping between the lowercase and uppercase characters with this mixed environment.
Environment
Japanese IBM i OS CCSID 1399 with Job Locale JA_JP.LOCALE
Diagnosing The Problem
Having a mismatch between the CCSID and Locale is not correct. Also per the following, CCSID 5026 is not supported with QShell.
https://www.ibm.com/support/knowledgecenter/ssw_ibm_i_73/rzahz/rzahznls.htm
The problem can be more easily seen by running the following in Qshell:
declare -u a=abcxyz
echo $a
If working correctly the echo should show a string of 'ABCXYZ'. When failing the echo will show a string of 'abcxyz'
Resolving The Problem
Changing the Job locale to JA_JP_1399.LOCALE to match the CCSID of 1399 resolved the issue.
It was also possible to circumvent the issue by issuing the CFGACCWEB command with this syntax:
CFGACCWEB "-APPSVRTYPE" "*INTAPPSVR" "-INSTANCE" "IWAIAS"
Document Location
Worldwide
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSB2FY","label":"IBM i Access Family"},"Component":"IBM i Access for Web;IBM i Mobile Access","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"r7.2","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]
Was this topic helpful?
Document Information
Modified date:
14 March 2019
UID
ibm10876224