Cause
System i Access could not start or could not access the TCP/IP
communications provider on your personal computer. Either the
communications provider is not installed, or is no longer in a
usable state.
Recovery
The provider must be BSD sockets compatible.
Install or re-install the TCP/IP communications provider and
verify that it is working correctly
Cause
The level of communications provider found is not supported by or
compatible with System i Access.
Recovery
Use a communications provider that is supported for use with
System i Access. The provider must be BSD sockets compatible.
Cause
An error occurred during communications. The name of the function
that failed, if available, and its error code are specified.
Recovery
Check the list below for the error code specified in the message
and take the action specified. If the function and/or error code
in the message are not listed here, they may be listed in
Informational APAR II10598 along with cause and recovery
information.
Error codes (for all functions)
8405 - The connection was initially established, but was disconnected by the server application before communications were completed. See message CWBCO1047 for additional information.
8411 - The connection attempt did not complete before the user configured timeout expired. The timeout can occur while querying the IP address or making the initial connection attempt to the system. See Connection Properties for information on configuring the connection. See message CWBCO1051 for additional information.
8413 - A user configurable time-out occurred during a send or receive attempt. See message CWBCO1054.
11001, 11002, 11003 - The system name was not found during TCP/IP address lookup. Verify the system name entered is correct. Verify the TCP/IP settings are correct for resolving addresses. See message CWBCO1004 for additional help. See Connection Properties for information on changing the IP address and mode.
11004 - The System i service name was not found in the local SERVICES file. Verify the required System i service names are correctly entered in the local SERVICES file.
Port numbers for host servers and server mapper:
| Service Name | Description | Port Number | Subsystem | Daemon | Server |
| as-central | Central server | 8470 | QSYSWRK | QZSCSRVSD | QZDASOINIT and QZSCSRVS |
| as-database | Database server | 8471 | QSERVER | QZDASRVSD | QZDASOINIT and QTFPJTCP |
| as-dtaq | Data queue server | 8472 | QSYSWRK | QZHQSRVD | QZHQSSRV |
| as-file | File server | 8473 | QSERVER | QPWFSERVSD | QNPSERVS and QIWVPPJT |
| as-netprt | Network print server | 8474 | QSYSWRK | QNPSERVD | QNPSERVS and QIWVPPJT |
| as-rmtcmd | Remote command / Program call server | 8475 | QSYSWRK | QZRCSRVSD | QZRCSRVS |
| as-signon | Signon server | 8476 | QSYSWRK | QZSOSGND | QZSOSIGN |
| as-svrmap | Server mapper | 449 | QSYSWRK | QZSOSMAPD | n/a |
| drda | DDM | 446 | QSYSWRK | QRWTLSTN | QRWTSRVR |
| as-usf | Ultimedia Facilities | 8480 | QSYSWRK | QUMBDMN | QUMBPJTC |
| as-admin-http | HTTP Administration | 2001 | QHTTPSVR | n/a | all within QHTTPSVR subsystem |
| as-mtgtctrl | Management Central | 5555 | QSYSWRK | n/a | QYPSSRV |
| telnet | Telnet server | 23 | QSYSWRK | n/a | QTVTELNET and QTVDEVICE |
See Connection Properties for information on changing the port mode.
10014, 10022 - The TCP/IP provider has detected an invalid argument. This can happen when the connection terminates and invalidates its resources before notifying the calling application. Try re-connecting and then try the action again.
10050, 10051 - The network is down or unreachable. Check your local and remote network settings.
10048 - The local socket address and port are already in use. Restart the application and try again.
10050, 10051, 10064, 10065 - No route to the system was found. Check your TCP/IP address and configuration. There may also be a network problem.
10052 - The system you were connected to somehow lost the knowledge of the connection, possibly due to a network failure or a "keep-alive" activity timeout. Try re-connecting and then try the action again.
10053 - The connection was established, but was broken by the client TCP/IP communications provider. Try re-connecting and then try the action again.
10054 - See 8405 above.
10055, 10067 - The TCP/IP provider has run out of resources to process your request. Your PC system may be too low on available memory, or you may have too many programs that use TCP/IP running. End any unnecessary programs and try the action again. If this error still occurs, shutdown and re-start your pc, and try the action again with as few other programs active as possible.
10057, 10058 - A request to send or receive failed because the socket had already been closed.
10060, 10064 - The address used was found, but the connection timed out. See CWBCO1048 for additional information.
10061 - The system was contacted, but refused the connection request. See CWBCO1049 for additional information.
10107 - The TCP/IP provider received a failure from an operating system call that should never fail. Check to make sure you have the latest operating system service pack installed.
Any other
Ask your systems administrator to verify that the host servers
are running on the system, and look for messages logged
that might indicate a network or other problem. If
there are routers in the network between your personal computer
and the system, the problem may be related to router
configuration or operation. Check for general network problems.
Cause
System i Access could not determine the IP address for the system.
Recovery
If you use a Domain Name Server (DNS), contact your network
administrator to verify that the DNS is operational. You can
determine if your PC can communicate with the DNS by using the
'ping' utility that comes with the TCP/IP communications support
you installed on your PC.
If you rely on the file on your PC called 'HOSTS' for IP address
resolution, verify that an entry exists in that file for the
system you are trying to connect to. For example, if the name is SYSA
and its IP address is 4.5.6.7, for address
resolution using the HOSTS file to work, the following entry must
exist in the HOSTS file:
4.5.6.7 SYSA
If an entry for the system exists in the HOSTS file, but the ping
utility fails to contact the system and tells you the name
you entered is an invalid IP address, the cause of failure may be
invalid characters in the system name. Which characters are valid
in a system name may vary from one TCP/IP implementation to
another. Try using a system name containing only letters ('a'-'z'
and 'A'-'Z'), numbers ('0'-'9'), dashes ('-') and periods ('.').
Add a new entry to the HOSTS file using the new system name, and
if the ping program can contact the system using that name,
System i Access should no longer fail with this message.
If you are not using either DNS or a HOSTS file for IP address
resolution, but do have a connection to the system configured in
System i Access, verify that the IP address field in the
Properties for that system's connection is correct. Also, verify
that the IP Address lookup mode is NEVER.
See Connection Properties
for information on changing the IP address and mode.
Cause
Connecting to the Service Mapper failed.
Recovery
Ensure that the TCP/IP host servers on the system are
started and see help for previous communications-related
messages.
For information on starting host servers, see How to Start Host Socket Servers.
Cause
The Service Mapper was found and contacted.
However, the port number to use for connecting to the specified
system was not successfully retrieved from the Service
Mapper.
Recovery
Notify your system administrator of this message. The existence
of an entry for the server application in the service table on
the host server must be verified. If this entry is missing, it can be
re-entered, or Option 12 (Host Servers) can be re-installed.
Cause
The Service Mapper was successfully contacted, but
connecting to the specified application server failed,
probably because the host server is not running. The
error code is specified.
Recovery
Verify that the system is ready to receive connections by
doing the following on the system:
* If the entry exists but the port number shown is different from the one listed in the CWBCO1022 message text, then either the System i Access configuration for the system specifies to lookup the remote port on the PC, or the services table on the system is incorrect. Have your systems administrator verify that the entry for the specified system is correct. See Connection Properties for information on configuring the connection.
* If there is no such entry, or if the State listed for the
entry is not Listen, the server application is not ready to
accept connections; see How to Start
Host Socket Servers. You may have to stop and restart
the host socket servers.
* If the entry exists and the state is Listen, there may be a problem related to one or more routers in your network not allowing connections to be made through them. Contact your system administrator for assistance.
See CWBCO1003 for details on the error code specified.
Cause
This message displays the name of the TCP/IP provider in use on
your PC.
Recovery
If you expected a different TCP/IP provider, contact whoever is
responsible for installing and configuring software on your PC
for assistance
Cause
The IP address could not be resolved.
Recovery
See message CWBCO1004 for recovery
methods to solve this problem.
Check previous messages for details.
Cause
The remote server port could not be resolved
Recovery
See Connection Properties
for information on changing the remote server port.
Check previous messages for details.
Cause
The attempt to connect to the specified system application
failed. Since this system application is not necessary
to complete a System i Access connection, this failure is a warning only.
Although a System i Access connection does not require that the specified system
application be running, some System i Access functions do; those
functions will not work until connecting to the system
application succeeds.
For example, if the system application as-database cannot be
connected to, System i Access data transfer and ODBC functions
will not work.
Recovery
See How to Start Host Socket
Servers
See previous messages for recovery information.
Cause
At least one failure occurred when trying to connect to a system application. A connection may be
established, but some System i Access functions will not work.
Recovery
See earlier messages related to the connection failures for
recovery information.
Cause
At least one failure occurred during the connection verification
that will prevent an System i Access connection from succeeding.
Recovery
See earlier messages for recovery information.
Cause
The connection verification was canceled, either by the user or
by the PC operating system, before it completed. No determination
was made of whether a System i Access connection will
succeed.
Recovery
To verify the connection, retry the operation without canceling.
If the connection verification seemed to take much too long to
complete (and so was canceled), it is likely that there is a
configuration problem. Have your network administrator help you
determine if communications are correctly configured on your PC
and on the system, and whether or not there are any
network problems.
Cause
The system you are verifying a connection to is running a
release older than V4R2M0. Most functions of System i Access will
not work correctly or at all when running to such OS/400 release.
Recovery
Connect to a system running release V4R2M0 or later, or
upgrade the release level of software on the system you were trying to verify
the connection to.
Cause
The specified communications provider is not ready for use.
Recovery
Verify that the communications provider is installed and
configured properly, and that basic functions, such as 'ping',
are working properly. Contact your network administrator to make
sure there are no problems with the network or its configuration.
Cause
The Signon transaction program is not functioning properly or
there is a network problem between your personal computer and the
system.
Recovery
Have your system administrator verify that the latest service
level for the Signon transaction program has been installed on
the system, and retry the operation.
Cause
The connection to the system is not configured correctly.
Recovery
Verify that the properties of that connection are correct, and
that the communication provider shown for that connection is what
you expected.
See Connection Properties
for information on configuring the connection.
Cause
Informational message - The remote port that will be used for
this connection is shown.
Recovery
If the connections fails, verify this is the correct remote port.
See Connection Properties
for information on configuring the connection.
See help for message CWBCO1008.
Cause
Informational message - The local port that will be used for this
connection is shown.
Recovery
See Connection Properties
for information on configuring the connection.
Cause
A condition exists that has prevented the cancel mechanism from
working properly. The connection verification will continue, but
if you try to cancel it, it may not end, or unpredictable results
could occur. This could be the result of low PC system resources.
Recovery
Try freeing PC system resources by ending unnecessary programs
(especially those that communicate with other systems) and
deleting unnecessary files from your hard disk, and try the
connection verification again. If the problem persists, shutdown
and restart your pc, and try again.
Cause
Informational message - The remote TCP/IP address lookup mode
that was used for this connection
Recovery
Verify the correct mode has been configured for this system.
See Connection Properties
for information on configuring the connection.
Cause
Informational message - The remote port lookup mode that was used
for this connection
Server - Always connect to the Service Mapper to determine the
port number for this service
Local - Always look in the local services file for the port
number
Standard - Always use the pre-defined port number
Recovery
Verify the correct mode has been configured for this system.
See Connection Properties
for information on configuring the connection.
Cause
Informational message - The TCP/IP gethostbyname() function will
be used to resolve the TCP/IP address.
Recovery
If this is not desired, or if the time interval at which this
happens needs to be changed, these settings can be changed.
See Connection Properties
for information on configuring the connection.
Cause
The system configuration parameter is not correct for the reason
code specified.
Recovery
Verify that the configuration for this system is correct. The
reason codes can be found in the header files in the Programmer's
Toolkit.
Cause
The server object instance could not be created for the reason
code specified.
Recovery
Verify that the configuration for this system is correct. The
reason codes can be found in the header files in the Programmer's
Toolkit.
Cause
Informational message - The remote TCP/IP address that will be
used for this connection attempt.
Recovery
See Connection Properties
for information on configuring the connection.
You may need to refer to this message if the connection attempt
fails.
Cause
Informational message - The local TCP/IP address that was used
for this connection
Recovery
You may need to refer to this message if the connection attempt
fails.
Cause
The connection was initially established, but was disconnected by
the system or server application before communications were
completed.
Recovery
Try the operation again. If the problem persists, have your
systems administrator check the system to verify that TCP/IP and
the host servers are running, and your connection is not
restricted by an IP filter. See How to
Start Host Socket Servers.
Have your system administrator check the server application job
logs and server subystems. See message CWBCO1003
for the names of the system jobs and the default names of the
subsystems.
This can also result from incorrectly configured routing on the
system when multiple routes to and from the systems are possible.
The result in this case is that packets sent are discarded because they are
too large. When this happens, TCP/IP on the PC assumes that the connection has
been ended by the system since it is not responding to the packets sent from the
PC, and reports error 10054 or 8405. Have your systems
administrator analyze the configuration of TCP/IP and associated
routing, as well as the maximum frame size configured for each
TCP/IP interface that may be reachable from the PC, and correct
any inconsistencies or problems with the configuration, then try
the operation again.
Cause
The address used for the system was found, but the connection timed out.
Recovery
Make sure TCP/IP has been started on that system, and that the
host servers have been started. If this does not fix the problem,
verify that the IP address used to attempt the connection is
correct. This address is logged in a previous
message.
Verify TCP/IP address servers (Domain Name Servers) are
configured correctly on this PC and have the correct address for
this system. If the address is correct, check the HOSTS file on
your computer for errors. If the IP address specified
in the HOSTS file is incorrect for the system, correct it and try
the operation again.
If a TCP/IP router of some kind exists on the network between the
PC and the system, make sure the router is configured to allow
connections to the System i Access host servers and to the Server
Mapper.
Cause
The system was contacted, but refused the connection request.
Recovery
Make sure the host servers have been started; see How to Start Host Socket Servers.
If a TCP/IP router, firewall or gateway of some kind exists on
the network between the PC and the system, make sure the router
is configured to allow connections to the System i Access host
servers and to the Server Mapper. If message CWBCO1022 was logged as well, this message
indicates the port number that must be allowed through the router
to perform the System i Access function being attempted.
Cause
A user specified timeout occurred trying to connect to the
system. A timeout can occur while querying the IP address or
making the initial connection attempt.
Recovery
Check the current configured timeout value for this system.
If your Domain Name Server is on another network, you might want
to consider changing your IP address lookup mode to be less
frequent. See Connection
Properties for information on changing the IP address and
mode.
Cause
A user configurable time-out occurred during a send or receive
attempt.
Recovery
Check the network for possible configuration or routing errors.
Adjust the time-out period.
Cause
An internal error occurred in System i Access communications. This
may be due to low PC system resources or may be a programming
error.
Recovery
Free some PC system resources by ending any unnecessary programs
and by deleting any unnecessary files from your hard drive, then
try the operation again. If the problem persists, shutdown and
restart your pc. If the problem remains, contact IBM Support.
Connection properties default values for your connections are maintained through the user's INI file. You can view and change default values that will be used by your applications when connecting to the specified system. Unique default values for each system can be set, however these values may be overridden at the application level.
Values can be set for:
Signon information - specifies what default user ID to use
Performance - specifies the properties of the
connection for the PC that can affect performance
To start all of the host socket servers on the system,
type the following command at the system command prompt:
STRHOSTSVR SERVER(*ALL)
To start just the signon server on the system, type:
STRHOSTSVR SERVER(*SIGNON *SVRMAP)
To use the socket servers, the QUSER profile on the system
must be enabled and the password must not be expired. One way to
make sure that the QUSER profile is always enabled is to set the
password with no expiration time value. To do this, type the
following command at the system prompt:
CHGUSRPRF USRPRF(QUSER) PASSWORD(*NONE) PWDEXP(*NO)
STATUS(*ENABLED) PWDEXPITV(*NOMAX)
If you are having trouble starting the host socket servers, try the following:
The various servers on the system have different
timeout values that come into play when the PC goes down before
the connection is disconnected. For example, in the case where
your PC goes into a hang condition before you can disconnect all
of your host server connections and data queues, you will have
server jobs active on the system until they timeout. This
timeout could be minutes, hours, or days, depending on the
server.
Ending the host servers does not clean up the jobs running on the
system when the ENDHOSTSVR command is run. The good
thing about not cleaning up jobs is that your host server
connections and data queues will continue to work after the
ENDHOSTSVR command is run. The downside to not cleaning up server
jobs on the system is that jobs that are still active prevent the
system from starting when the STRHOSTSVR command is run.
When ending and restarting host servers on the system, you should
use the CWBPING command from a System i Access Express workstation
to make sure the host servers actually start back up. If they do
not start back up, use the NETSTAT command and end any active
jobs with TCP/IP addresses next to them.