In case of problems check the status of your connections first.
- Type in the command "ping 127.0.0.1" in a MS/DOS window to check the PC network card.
- If the message is not "Reply from 127.0.0.1 bytes=32 time=x ms TTL=64" check the configuration of your network card and make sure that it works.
- If the message is "Reply from bytes...time...TTL... ", the card works and gives a reply time, go to point 2.
- Type in command "ping 172.16.20.78" when 172.16.20.78 is the IP address of your PC.
If you do not receive the right message
- Check all physical connections of your PC: cable, connections to HUB, connection to the power supply network.
- Check the TCP/IP configuration of your PC in Windows.
If you receive a positive reply, go to point 3.
- Type in the command "ping S44XXXXX" to check the connection between the PC and your iSeries (replace S44XXXXX by the symbolic name of your iSeries or its IP address):
If you do not receive the right message:
- Check the connection of the iSeries to the power supply network (cables, plugs...) and make sure that TCP/IP has been started on the iSeries, then go to point 4.
If you receive a positive reply, go to point 5.
- In a iSeries session, type in "ping '172.16.3.1'", when 172.16.3.1 is the IP address of your iSeries.
Check the reply on this sending (display the details of the message at the bottom received with F1 on the message field and then press F10 for the details).
- If the message is "No responses from...", check if TCP is started on the iSeries and check the iSeries configuration.
- If the message is "Connection verification ...successful", the connection PC<->iSeries should be established.
- If not, go to point 5.
- Check the IP addresses and the masks allocated to the PC and to the iSeries and check the configuration again.
- Check the simbolic name and the IP address of your iSeries and the availability:
- in the "HOSTS" file. On your PC if it is used.
- or in the DNS of your network. In this case ask your system administrator if your are using the DNS.
- Access filter:
If your PC network is equipped by a firewall or a Proxy server, check the corresponding configuration (access rights).
- Make sure the HTTP server is in working conditions
Type in the command "WRKTCPSTS *CNN" and check the status of the HTTP server. In the column "Local port" the port 'www-http' or 'www' or the figure '80' must be available and the status must be 'listen'.
- Make sure that your HTTP configuration is valid in HTTP configuration iSeries of the documentation "Installation - Start-up". If your HTTP server still doesn't work, call your IBM support.
In case of a network with Proxy server, contact your administrator and deactivate temporarily the Proxy to check this way if the Proxy causes the error. See error "Java I/O exception cannot connect to remote post".
This generally appears with a Proxy server: this means that it is not or not correctly configured. In this case go to Options Internet of your browser and:
- either tick "do not use Proxy server" if you do not have any and the browser will no longer search;
- or configure it with the right reference IP address to ensure correct function.
This message appears if you type an URL such as
" http://S44XXXXX/minosweb/run?XXXXX ". (1).
XXXXX represents the access code you received for connection with the iSeries.
- either the spelling of the code was not correct, then type it again (capitals and small letters are insignificant).
- or the access code is no longer valid, contact your administrator.
This message appears if you type an URL such as " http://S44XXXXX/minosweb/run?XXXXX ". (1).
XXXXX represents the access code you received for connection with the iSeries, ZZZZZ represents the MINOS Web client related to the access code.The client related to the access code is no longer available.
Check in the configuration of MINOS Web that this configuration is available: type "MINOSWEB2/CONFIG" (2), then select option 2 of the menu and look if the client ZZZZZ is available. If not, replace the client ZZZZZ in the corresponding access by an available client or create the client ZZZZZ. (see user manual).
This message appears if you type an URL such as " http://S44XXXXX/minosweb/run?XXXXX ". (1).
XXXXX represents the access code you received for connection with the iSeries.Template related to this access code not found.
YYYYY = template library
ZZZZZ = name of file containig the templates ('TEMPLATE')
TTTTT = template name (file member ZZZZZ)Check with strpdm that the template is available. If it is not available, you must replace the related template value to the corresponding access code (XXXXX) by an available value (use MINOSWEB2/CONFIG" (2), then select option 3 from the menu, select the access code XXXXX) or re-install the file not found. To do this, contact your administrator.
This message appears if you type an URL such as " http://S44XXXXX/minosweb/run?XXXXX ". (1).
XXXXX represents the access code you received for connection with the iSeries.One of the configuration files not found.
BBBBB = file library
FFFFF = name of the file not found.
Z = error number generated by the attempt to open the fileCheck with strpdm that the file is available. If it is not available, you must re-install the product or restore the file not found. To do this, contact your administrator.
If the file is available, possibly the rights granted to the file are not correct.
Check, if the user QTMHHTP1 has rights for the file (command EDTAUTOBJ).
This message appears if you type an URL such as " http://S44XXXXX/minosweb/run?XXXXX&YYY=ZZZ ". (1).
XXXXX represents the access code you received for connection with the iSeries.You have completed the URL with a parameter (&YYY=ZZZ).
Check the reason why the URL uses parameters.
The access code XXXXX used does not allow the use of parameters. This occurs if the used access opens a screen session for example.
If the used access is a screen session, delete the parameters by typing the URL as " http://S44XXXXX/minosweb/run?XXXXX "
This message appears if you type an URL such as " http://S44XXXXX/minosweb/run?XXXXX&YYY=ZZZ ". (1).
XXXXX represents the access code you have received for the connection with the iSeries.
Example : http://S44XXXXX/minosweb/run?MINOSWEB_US¶m=valeurYou have completed the URL with one or several parameters (&YYY=ZZZ).
The value represented by YYY is not recognised by the CGI program.Example : http://S44XXXXX/minosweb/run?TRF_MINOSWEB_US&REQ=SAUVE
This message appears if you type an URL such as " http://S44XXXXX/minosweb/run?XXXXX&REQ=YYYYY ". (1).
XXXXX represents the access code you have received for the connection with the iSeries.
YYYYY represents the code of the backup script which should be executed automatically.
ZZZZZ represents the code of the of the client related to specific access XXXXX
This message appears, if the code of the backup script has not been found. Check with your administrator, if this code is valid:
- Check of the automatic client related profile ZZZZZ
- Check the availability of the script code record ST=YYYYY for the client ZZZZZ and the related automatic profile.
To do this use the command MINOSWEB2/CONFIG (2)
This message appears if you type an URL such as " http://S44XXXXX/minosweb/run?XXXXX&REQ=ZZZZZ ". (1).
XXXXX represents the access code you have received for the connection with the iSeries.
ZZZZZ represents the code of the backup script which should be executed automatically.
The value ZZZZZ has an incorrect length: inferior to 1 or superior to 5.
Type URL again and check the value of the parameter REQ.
This message appears if you type an URL such as
" http://S44XXXXX/minosweb/run?XXXXX ". (1).
XXXXX represents the access code you received for connection with the iSeries.The rights granted to the object LM0206L of the library MINOSWEB2 are not correct.
Make sure that the object has the following rights (command 'DSPOBJAUT') :Owner: QTCP
User Rights QTCP *ALL QSECOFR *ALL QTMHHTP1 *USE *PUBLIC *EXCLUDE This rights have been assigned to the object during installation of the version. If the rights are not correct, use the command 'EDTOBJAUT'.
This message appears if you type an URL such as
" http://S44XXXXX/minosweb/run?XXXXX ". (1).
XXXXX represents the access code you received for connection with the iSeries.Make sure that the user QTMHHTP1 is '*ENABLED', use the command 'WRKUSRPRF'.
Only the logo ORDIROPE is displayed:
- You do not have enough user rights for your PC.
- or no virtual Java machine is installed on your PC: Se manual MINOS Web - chapter "System and network" - paragraph "Development on the client workstations"
- See Sun Help at http://java.com/en/download/help/index.xml
The problems are shown either on the 'htm' page, or in the queue of the QTCP messages. You must also check in this queue, if the server ORDSRV2TCP or ORDSRV2TST is active.
To carry out this verification:If you are in Production mode:
Check if the server ORDSRV2TCP is active by the message " Server ORDSRV2TCP active on port 3011 " (type the command "DSPMSG QTCP").If you are in Test mode:
Check if the server ORDSRV2TST is active by the message " Server ORDSRV2TST active on port 3012 " (type the command "DSPMSG QTCP").If the server (ORDSRV2TCP or ORDSRV2TST) is not active,
If you are in Production mode:
Check if the command "MINOSWEB2/MINOSWEB MODE(*PROD)" (2) has been carried out and MINOS Web is started on the iSeries or if the command has been carried out during start-up of the iSeries if it has been shut down.If the message " Error : Server ORDSRV2TCP not started on port 3011. A TCP/IP application already uses this port, or this server has already been started." is displayed in the QTCP message queue:
- That means that MINOS Web has been started minimum two times: starting MINOS Web corresponds to an interactive start of a job submit.
ORDSRV2TCP (Program LM0200C) is the MINOS Web server for production mode; it occupies by default the port 3011. If it is started a second time, the new job will be ignored because the port is already occupied: the second start will fail.OR
- It is because the port 3011 is occupied by another TCP/IP application. In this case the port 3011 cannot be used, because it is already occupied. Therefor you must modify the server configuration and change the port value.
Note: this may occur, if you are using version 1 of MINOS Web which occupies the port 3011.If you are in Test mode:
Check if the command "MINOSWEB2/MINOSWEB MODE(*TEST)" (2) has been carried out and MINOS Web is started on the iSeries or if the command has been carried out during start-up of the iSeries if it has been shut down.If the message " Error : Server ORDSRV2TST not started on port 3012. A TCP/IP application already uses this port, or this server has already been started." is displayed in the QTCP message queue:
- That means that MINOS Web has been started minimum two times: starting MINOS Web corresponds to an interactive start of a job submit.
ORDSRV2TST (Program LM0200C) is the MINOS Web server for test mode; it occupies by default the port 3012. If it is started a second time, the new job will be ignored because the port is already occupied: the second start will fail.OR
- It is because the port 3012 is occupied by another TCP/IP application. In this case the port 3012 cannot be used, because it is already occupied. Therefor you must modify the server configuration and change the port value.
Note:
If the messages of the QTCP queue have been deleted, check the availability of the servers with the command 'WRKACTJOB'.Example of a message displayed by the applet if the server has not been started:java.io.IOException: A connection with a remote host was closed
The files (DATQ or DTAARA) must be deleted and the server be re-started.
To do this, type the command "STRPDM" choose option 2 "Object management", then enter the library MINOSWEB2 (2). The objects list is displayed. Now enter in 'Display from' "ORD*": delete the objects ORDSRV2TCP type *DTAQ and *DTAARA.
The files (DATQ or DTAARA) must be deleted and the server be re-started.
To do this, type the command "STRPDM" choose option 2 "Object management", then enter the library MINOSWEB2 (2). The objects list is displayed. Now enter in 'Display from' "ORD*": delete the objects ORDSRV2TST type *DTAQ and *DTAARA.
The connection to the iSeries passes a Firewall which recognises the port 80 but not the port 3011 (production mode) or 3012 (test mode). The HTML page is load but not the sign-on screen. If you are using a 'TCP/IP mapping', verify with the administrator of your Firewall of the access to port 3011 or 3012 is redirected to the iSeries for the same reason as the port 80. Check also, if the management filters of the Firewall authorize the input and output of the IP packets on the port 3011 or 3012.
if you receive a message like "Java lang exception. Java.net.ConnectException: connection refused" and you work with a Proxy server, you must disconnect the server for the local addresses.
With Internet Explorer:Go to "tools" of Internet Explorer
then to "Internet options",
click on tab "connections"
then select button "LAN parameters";
click button "Advanced.. ";
activate the button "do not use Proxy with the local addresses".
add in field "do not use Proxy for addresses beginning with... "http://S44XXXXX
Your IP address is not authorised in the MINOS Webconfiguration, or has been refused by EXIT PROGRAM.Contact your administrator to use MINOSWEB2/CONFIG, and: (2)
Check for the server AND the client concerned:
- the configuration of the authorised IP addresses,
- the correct running of the exit program of the IP addresses control, if there is one.
This error appears in case of configuration of a workstation ID for the client IP address and the client concerned.
It occurs when log-on is requested in a new browser window and a session has already been opened and runs in another browser window. The name assigned to the new session to be opened is already given to the first session.
In this case you must open the new session from the first session in the menu "Session" - "New", or press CRTL-F1.
Ask for a key with the questionnaire www.ordirope.com/key_us.htm because your key is no longer valid.
The limit of use has been exceeded. Therefore you can only use five session at the same time. Contact the sales service to ask for software license details for more than five users.
Check in the the availability of the MINOS Web configuration: enter "MINOSWEB2/CONFIG"(2), then select option 2 from the menu and see if the file MINOSWEB_xx is available. (xx corresponds to the letters of your language: fr or us or es. If not load the product on the iSeries again or create your own client configuration (see user manual).
MINOS Web has been load after a direct click on the htm page from the Windows Explorer and not using a browser.
A browser is needed to start MINOS Web: the Java applet is download on the client workstation with the HTTP server of the iSeries.
The protocol mailto is not supported by the plug-in java.
- Check if the system value QAUTOVRT is not equal 0 and the value is sufficient (or *NOMAX)
- Check whether the sub-system QBASE accepts all workstation types (screens running in QBASE) with the command "WRKSBSD SBSD(QBASE)", type in 5before QBASE and then select option 5: check availability of *ALL in the column TYPE. If *ALL is not available, use the command "ADDWSE SBSD(QBASE) WRKSTNTYPE(*ALL)" to add this parameter.
The entered profile is not correct, with * or empty.
The MINOS Web configuration does not allow this profile.
The profile is *DISABLED.
Password incorrect.
No password.
Profile not available.
The entered profile has no read rights on its object *USERPRF in QSYS
For information on the MINOS Web Systray connection: right mouse click on the icon MINOS Web Manager (beside the time in the Windows task bar).
Select "Connection", then "Information" :
The MINOS Web Systray configuration on the iSeries server for your workstation has not been found: contact your responsible iSeries system administrator for the MINOS Web server configuration.
The entered field "IP address of host system" in the screen "Configuration", "Connection" of MINOS Web Systray is not correct.
The entered field "Port" in the screen "Configuration", "Connection" of MINOS Web Systray is not correct.
The entered field "Name of host system" in the screen "Configuration", "Connection" of MINOS Web Systray is not correct.
Other socket errors may occur (error code 10xxx to 11xxx). These errors may occur due to network problems for example.
For more details on these error codes: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winsock/winsock/windows_sockets_error_codes_2.asp
- Exceptions have been discovered on certain OS.
- apply the last cumulative on the iSeries
- on PC apply the last service pack.
- The PDF spools are not displayed in the browser window although Acrobat Reader is installed on the PC
This problem due to Acrobat Reader occurs often in version 4:
- Install a more recent version of Acrobat Reader
- or start Acrobat Reader on the PC, click "File, Preferences, General", and unselect "Web Browser Integration"
- Connection time very long:
If your PC runs with WINDOWS 2000 and the OS/400 of your iSeries is V5R1 with very long connection times:
a PTF cumulative must be installed on your iSeries, minimum level TL03007.
- Make sure that you are not in debug mode
See above chapter 7. DEBUG mode
- If you use the Java plug-in 1.5
- Make sure that the Java console is activated on your PC: click on "Start"
"Configuration panel",
"Java plug-in"
tab "Advance"
and select "Display console",
then click "Apply".
Exceptions have been discovered on various browsers. In case of problems update your browser (specially the Java Virtual Machine).
The Popup windows (for example when starting option 3 or 7 of the MINOSWEB2/SPOOL command) are not displayed:
Check whether a suppression software for popup windows or a "personal Firewall" is installed on the PC (example "Popup flash").
In this software type an URL configuration is possible to de-activate the suppression of the Popup windows. You must therefore add your iSeries server to this list.
| In DEBUG mode the response time is much higher. |
The DEBUG mode is not active by default. The DEBUG mode is indicated with a "D" at the right bottom of the MINOS Web window.
Before activating the DEBUG mode we recommend to empty the QTCP messages:
Use the command "DSPMSG QTCP", F13=Remove all
- Activation / De-activation of DEBUG mode
- Use the command MINOSWEB2/CONFIG
Option 1 "Server configuration"
Option 1 "General configuration"
Modify field "All operations (debug mode)"- Recuperation of the generated traces
- The messages are sent to QTCP.
- Use the command "DSPMSG MSGQ(QTCP) OUTPUT(*PRINT)" to generate a spool containing the messages.
Then use the command MINOSWEB2/SPOOL, trace the spool "QPDSPMSG".- The spool can be displayed or saved in file to be sent to the MINOS Web hot line service if necessary (see below 6.8. Error handling).
Traces may also be generated in the QEZJOBLOG queue.
Use the command "MINOSWEB2/SPOOL USER(QTCP) ", find the spools in the column Reference:The spools can be displayed or saved in file to be sent to the MINOS Web hot line service if necessary (see below 6.8. Error handling).
- ORDSRV2TST
- or ORDSRV2TCP
- or beginning with ORMW
- or beginning with ORTF
- or beginning with ORSP
- or beginning with ORPC
- Activation / De-activation of DEBUG mode
- Use the command MINOSWEB2/CONFIG
Option 2 "Client configuration"
Option 2 before the name of the client concerned
Option 2 "Screen session configuration"
Option 2 "Trace options, Exit programs and various "
Modify field "All operations (debug mode)"- Recuperation of the generated traces
In addition to the generated traces on server level (see below paragraph 6.7.1. MINOS Web server - Recuperation of generated traces), a spool named "ORMW2TRC" is generated with user "QTCP".
Use command "MINOSWEB2/SPOOL USER(QTCP) ", find spool "ORMW2TRC ".- The spool can be displayed or saved in file to be sent to the MINOS Web hot line service if necessary (see below 6.8. Error handling).
- Activation / De-activation of DEBUG mode
- If debug mode has been activated on the MINOS Web client on the iSeries server (see below), debug mode is active on PC side.
- DEBUG mode may be run on the client workstation when assigning action "323" to a keyboard key (for example "Ctrl" + "Shift" + "Home"); this way the DEBUG mode can be activated or de-activated easily.
- Recuperation of the generated traces
- The traces are displayed in the Java console on the client workstation.
- See above chapter 6.6.1. Display of the JAVA console
The generated traces in the Java console can be saved in a file (copy-paste) to be transmitted to the MINOS Web service hot line if necessary (see below 6.8. Error handling).
- Activation / De-activation of DEBUG mode
- Use the command MINOSWEB2/CONFIG
Option 3 "Client configuration"
Option 2 before the name of the client concerned
Option 2 "Transfer session configuration"
Option 2 "Trace options, Exit programs and various "
Modify field "All operations (debug mode)"- Recuperation of the generated traces
- In addition to the generated traces on server level (see below paragraph 6.6,1. MINOS Web server - Recuperation of generated traces), a spool named "ORTF2TRC" is generated with user "QTCP".
Use command "MINOSWEB2/SPOOL USER(QTCP) ", find spool "ORTF2TRC".- The spool can be displayed or saved in file to be sent to the MINOS Web hot line service if necessary (see below 6.8. Error handling).
- Activation / De-activation of DEBUG mode
- If debug mode has been activated on the MINOS Web client on the iSeries server (see below), debug mode is active on PC side.
- Recuperation of the generated traces
- The traces are displayed in the Java console on the client workstation.
For display of the Java console click "Display", "Java Console" in the Internet Explorer window.- If the Java console was not activated on your PC, click "Tools", "Internet options", "Advanced" and select "Java Console Activated".
The traces generated in the Java console may be saved in a file (copy-paste) to be transmitted to the MINOS Web service hot line if necessary (se below 6.8. Error handling).
- Activation / De-activation of DEBUG mode
- Use the command MINOSWEB2/CONFIG
Option 1 "Server configuration"
Option 5 "Configuration of applications remote PC"
Option 1 "General configuration"
Modify field "All operations (debug mode)"- Recuperation of the generated traces
- A spool with the name "ORPC2TRC" is generated with the user "QTCP".
Use command "MINOSWEB2/SPOOL USER(QTCP) ", find spool "ORPC2TRC".- The spool can be displayed or saved in file to be sent to the MINOS Web hot line service if necessary (see below 6.8. Error handling).
- Activation / De-activation of DEBUG mode
- Right click on icon "MINOS Web Manager" (beside the time in the Windows task bar)
Configuration- Connection
Log level: activate "Debug"
- Obtention of the generated traces
- Re-launch start operation (including connection)
To find "mwtray.log" file :- Client workstation under Windows 2000, XP, Millenium, TSE and NT :
Go to directory : C:\Documents and Settings\xxxxxx\Application Data\Ordirope\MinosWeb Manager
(xxxxxx has to be replaced by the name of the user of the Windows session).- Get the file "mwtray.log" and transmit it to the MINOS Web hot line service if necessary (see below 6.8. Error handling).
- Activation / De-activation of DEBUG mode
- Use the command MINOSWEB2/CONFIG
Option 1 "Server configuration"
Option 5 "Configuration of applications remote PC"
Option 1 "General configuration"
Modify field "All operations (debug mode)"- Search of the generated traces
- A spool with the name "ORSP2TRC" is generated with the user "QTCP".
Use command "MINOSWEB2/SPOOL USER(QTCP) ", find spool "ORSP2TRC "; the spool can be displayed or saved in file to be sent to the MINOS Web hot line service if necessary (see below 6.8. Error handling).
- Determination of configuration and traces files directory
- Client workstation under Windows 2000, XP, Millenium, TSE and NT :
Go to directory : C:\Documents and Settings\xxxxxx\Application Data\Ordirope\MinosWeb Manager
(xxxxxx has to be replaced by the name of the user of the Windows session).
- Activation / De-activation of DEBUG mode
- Right click on icon "MINOS Web Manager" (beside the time in the Windows task bar)
Configuration- Minosweb spool
select "Debug mode"
- Recuperation of the generated traces
- Edit again the spool which causes problems
To fing the generated file : Traces files have the following name : ORD_SPL1_xxxxxx_yyyyyy_aaaaaaaabbbbbb.TRC
- xxxxxx : job number
yyyyyy : Spool index
aaaaaaaa : Edition date under format ccyymmdd (cc=centuty yy=year mm=month dd=day)
bbbbbb : Edition time under format hhmmss (hh=hour mm=minute ss=second)- The trace file can be transmitted to the MINOS Web hot line service if necessary (see below 6.8. Error handling ).
If you wish to contact the MINOS Web assistance service, you are invited to:
According to the type of your problem:
- You can send a copy of the screen(s) to explain the problem (the recommended formats are: GIF, JPEG, BMP. Remember to compress the images in zip)
- Deliver also the generated trace elements on the server (see above paragraph 6.7.1. MINOS Web server)
- 02. Spools management (MINOSWEB2/SPOOL)
- If the problem concerns a particular spool, give us the following information on the spool:
- The type: (*SCS, *AFPDS, *USERASCII)
- The contents: in case when the problem concerns a keyword in the DDS
Please send SAVF files containing your PRTF source file.
You can send the whole source file or parts of it in a text file
- 03. Mail management (MINOSWEB2/MAIL)
- If the problem comes from the server configuration, please give us the entered parameters.
Use the command "MINOSWEB2/CONFIG" and note the entered elements in the screen "General configuration"Option 01: Server configurationIf the problem derives from the exit programs, please send us all elements to identify the functionality of the exit programs you are using.
Option 04: Mail management
Option 01: General configuration
+ Option 02 : Encoding
- 04. Use of a screen session (applet)
- Se above paragraph 6.7.2. MINOS Web Screen session
- 05. Use of a transfer session (applet)
- Se above paragraph 6.7.3. MINOS Web Transfer session
- 06. Use of the application PC Systray
- Se above paragraph 6.7.4. MINOS Web Systray
- 07. Printing via Minos Web Spool
- Se above paragraph 6.7.5. MINOS Web Spool
Please deliver details on the edited spool.
In case of a spool using resources (*OVL, or *PAGSEG), please send the corresponding objects in a SAVF file.
- 08. Documentation
- You should specify the concerned page(s) as well as problems occurred.
- 09. Installation of Minos Web
- If the problem derives from the object installation: please send us the contents of the command DSPJOBLOG linked to the command RSTLICPGM.
If the problem derives from the installation of a new version to replace another one, please send the information
concerning the replaced version, the previously used configuration...
- 50. More
- You can send us all documents allowing us to resolve the best and fast possible your problem.
(1) /minosweb is the default directory for the installation of the files maintained by the HTTP server. If you have modified this value during installation of MINOS Web, detail the chosen directory. (and complete with /*)
Example : /minosweb/* to be replaced by /mydirectory/*
(2) MINOSWEB2 is the default library for the installation of the iSeries files of Minos Web. If you have modified this value during installation of MINOS Web, detail the chosen library. (and complete with .LIB)
Example : MINOSWEB2.LIB to be replaced by MYLIB.LIB