How to change aXes configurations and troubleshooting
Please refer to the aXes Automatic Installation Guide for information about:
- Installing aXes
- How to configure the aXes configuration file.
Contact your local vendor regarding the license options or for further information about aXes.
Changing the default CCSIDs
While it should not be necessary, the following examples show changes that you may choose to make to the aXes default CCSIDs for aXes Terminal Server, aXes Data Explorer or aXes Spooler File Server files.
For further details refer to aXes Reference Guide.
Changing the configuration file - aXes Terminal Server
English example
The job details are as follows:
Job Attribute |
Value |
|---|---|
|
Language identifier |
*SYSVAL |
|
Country or region identifier |
*SYSVAL |
|
Coded character set identifier |
*SYSVAL |
|
Default coded character set identifier |
*SYSVAL |
System values are:
System Variable |
Value |
|---|---|
|
QCHRID |
= 697 / 37 |
|
QCHRIDCTL |
= *DEVD |
|
QCNTRYID |
= US/AU |
|
QLANGID |
= ENG |
French example
The job details are as follows:
Job Attribute |
Value |
|---|---|
|
Language identifier |
*SYSVAL |
|
Country or region identifier |
*SYSVAL |
|
Coded character set identifier |
*SYSVAL |
|
Default coded character set identifier |
*SYSVAL |
System values are:
System Variable |
Value |
|---|---|
|
QCCSID |
= 65535 |
|
QCHRID |
= 697 / 297 |
|
QCHRIDCTL |
= *DEVD |
|
QCNTRYID |
= FR |
|
QLANGID |
= FRA |
Japanese example
The job details are as follows:
Job Attribute |
Value |
|---|---|
|
Language identifier |
*SYSVAL |
|
Country or region identifier |
*SYSVAL |
|
Coded character set identifier |
*SYSVAL |
|
Default coded character set identifier |
*SYSVAL |
System values are:
System Variable |
Value |
|---|---|
|
QCCSID |
= 5035 (DBCS) |
|
QCHRID |
= 1172 / 1027 |
|
QCHRIDCTL |
= *DEVD |
|
QCNTRYID |
= JP |
|
QLANGID |
= JPN |
Thai (English) example
The job details are as follows:
Job Attribute |
Value |
|---|---|
|
Language identifier |
ENG |
|
Country or region identifier |
US |
|
Coded character set identifier |
65535 |
|
Default coded character set identifier |
37 |
Select option 39. Work with aXes Servers
Use option 22 (Edit configuration) against the aXes server *AXESTS
Locate the line containing HostCCSID and DefaultKeyboardType and change them to:
HostCCSID = 838
DefaultKeyboardType=THB
Press F3 Save/Exit
Changing the configuration file - aXes Data Explorer
English example
The job details are as follows:
Job Attribute |
Value |
|---|---|
|
Language identifier |
*SYSVAL |
|
Country or region identifier |
*SYSVAL |
|
Coded character set identifier |
*SYSVAL |
|
Default coded character set identifier |
*SYSVAL |
System values are:
System Variable |
Value |
|---|---|
|
QCCSID |
= 65535 |
|
QCHRID |
= 697 / 37 |
|
QCHRIDCTL |
= *DEVD |
|
QCNTRYID |
= US/AU |
|
QLANGID |
= ENG |
French example
The job details are as follows:
Job Attribute |
Value |
|---|---|
|
Language identifier |
*SYSVAL |
|
Country or region identifier |
*SYSVAL |
|
Coded character set identifier |
*SYSVAL |
|
Default coded character set identifier |
*SYSVAL |
System values are:
System Variable |
Value |
|---|---|
|
QCCSID |
= 65535 |
|
QCHRID |
= 697 / 297 |
|
QCHRIDCTL |
= *DEVD |
|
QCNTRYID |
= FR |
|
QLANGID |
= FRA |
Select option 39. Work with aXes Servers
Use option 22 (Edit configuration) against the aXes server *AXESTS
Locate the line containing HostCCSID and change it to:
HostCCSID = 37
Press F3 Save/Exit
Japanese example
The job details are as follows:
Job Attribute |
Value |
|---|---|
|
Language identifier |
*SYSVAL |
|
Country or region identifier |
*SYSVAL |
|
Coded character set identifier |
*SYSVAL |
|
Default coded character set identifier |
*SYSVAL |
System values are:
System Variable |
Value |
|---|---|
|
QCCSID |
= 5035 (DBCS) |
|
QCHRID |
= 1172 / 1027 |
|
QCHRIDCTL |
= *DEVD |
|
QCNTRYID |
= JP |
|
QLANGID |
= JPN |
Changing the configuration file - aXes Spool File Server
English example
The job details are as follows:
Job Attribute |
Value |
|---|---|
|
Language identifier |
*SYSVAL |
|
Country or region identifier |
*SYSVAL |
|
Coded character set identifier |
*SYSVAL |
|
Default coded character set identifier |
*SYSVAL |
System values are:
System Variable |
Value |
|---|---|
|
QCCSID |
= 65535 |
|
QCHRID |
= 697 / 37 |
|
QCHRIDCTL |
= *DEVD |
|
QCNTRYID |
= US/AU |
|
QLANGID |
= ENG |
French example
The job details are as follows:
Job Attribute |
Value |
|---|---|
|
Language identifier |
*SYSVAL |
|
Country or region identifier |
*SYSVAL |
|
Coded character set identifier |
*SYSVAL |
|
Default coded character set identifier |
*SYSVAL |
System values are:
System Variable |
Value |
|---|---|
|
QCCSID |
= 65535 |
|
QCHRID |
= 697 / 297 |
|
QCHRIDCTL |
= *DEVD |
|
QCNTRYID |
= FR |
|
QLANGID |
= FRA |
Select option 39. Work with aXes Servers
Use option 22 (Edit configuration) against the aXes server *AXESTS
Locate the line containing HostCCSID and change it to:
HostCCSID = 37
Press F3 Save/Exit
Japanese example
The job details are as follows:
Job Attribute |
Value |
|---|---|
|
Language identifier |
*SYSVAL |
|
Country or region identifier |
*SYSVAL |
|
Coded character set identifier |
*SYSVAL |
|
Default coded character set identifier |
*SYSVAL |
System values are:
System Variable |
Value |
|---|---|
|
QCCSID |
= 5035 (DBCS) |
|
QCHRID |
= 1172 / 1027 |
|
QCHRIDCTL |
= *DEVD |
|
QCNTRYID |
= JP |
|
QLANGID |
= JPN |
Configure and change shipped defaults
Set the library list:
This is the name of the language library used in the LANGLIBE parameter when installing. If *SAME was used the name will be AXESxxxx where xxxx is the language code.
Change the aXes Job description library list to include this library.
Then, for all languages, do this:
ADDLIBLE AXES (or the equivalent aXes product library)
Set aXes to start with the subsystem
Type GO CMDAXES
Select option 10. Change aXes application server:
- Change parameter instance to AXES
- Change the last parameter AUTOSTART SERVER to *YES
- Press Enter.
Change the default port number
If you are not already in the aXes menu use GO CMDAXES:
Ensure aXes default port 80 is not in use. To check try this in a web browser:
http://<yourhostname>:80
If the port number is in use, you need to use another port:
Select option 39. Work with aXes Servers:
- Press Enter
- Use option 22 (Edit configuration) against the aXes server *AXESW3
- Locate the line containing # Port=80, remove the # character and update to the required port number
- F3 Save/Exit
Make sure the port number is not blocked by web browser default configurations. At http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers is a list of registered TCP/IP ports. We recommend any port number greater than 1023 and not listed in the Wikipedia list (e.g.: 8085) or listed with Status = Unofficial (e.g.: 8081).
Also check http://www.iana.org/assignments/port-numbers to ensure the port number is not well known or registered.
Changing the default CCSIDs:
Usually changing the default CCSIDs is not necessary.
If required, please refer to the aXes configuration change examples in: How to change aXes configurations
Updating the library for aXes Spool File and Data Explorer Server:
If you have upgraded your aXes installation, you get the following message:
Open the https.xml configuration file at the following location:
<your JSM directory>/jsm/instance/system/httpd.xml
Typically, this would be located at:
AXESJSM/jsm/instance/system/httpd.xml
And change the following lines to use the JSM library for your install. Typically this would be the name of your aXes installed library followed by JSM. So if you have installed axes in the AXES library, you would use AXESJSM
Around Line 206 for DE:
<parameter name="database.library" value="AXESJSM"/>
Around line 229 for WS
<parameter name="database.library" value="AXESJSM"/>
Updating the library for aXes Spool File and Data Explorer Server:
If you have upgraded your aXes installation you might want to change your default jQuery Theme.
Open the aXesTS.conf file at <axes_fdirectory>/config/axests.conf
Find the following line. Please note it might hold some different values:
TS2defaulttheme=theme_default
And add the following line below.
TS2defaultjqtheme=smoothness
The first line defines the default basic theme for aXes-TS2 sessions.
The second line defines the jQuery default theme for aXes-TS2 default configuration.
