message
Explanation
The procedure clnt_sperror(), which returns the
address of a message indicating why an RPC did not complete, returned
the displayed message. This procedure receives pointers previously
declared in the clnt parameter of the clnt_create(),
clntudp_create(), clnttcp_create(), or clntraw_create() procedures.
The clnt parameter is the pointer to a client handle
that was obtained using one of the above procedures. Depending on
the location where the procedure stopped, only one of these messages
will be displayed.
System action
Operator response
Inform the system programmer of this message.
System programmer response
Possible responses for this message
are:
- Message
- Response
- RPC: Success
- None.
- RPC: Can't encode arguments
- Check for the correct XDR procedure name in the inproc parameter
of the callrpc() call and restart the program.
- RPC: Can't decode result
- Check for the correct XDR procedure name in the outproc procedure
of the callrpc() call and restart the program.
- RPC: Unable to send
- Check for the correct parameter entries in the callrpc() call
and restart the program.
- RPC: Unable to receive; errno = value, error
list
- Check for the correct parameter entries in the callrpc() call
and restart the program.
- RPC: Timed out
- Restart the program if required.
- RPC: Incompatible versions of RPC; low version = version,
high version = version
- Check for the correct remote program version number in the versnum parameter
of the callrpc() call and restart the program.
- RPC: Authentication error; why = reason
- Check for the correct entries in the authentication parameters
of the authunix_create() call.
- RPC: Authentication error; why = unknown authentication error
- value
- Check for the correct entries in the authentication parameters
of the authunix_create() call.
- RPC: Program unavailable
- Check for the correct program number in the prognum parameter
of the callrpc() call, register the program using the registerrpc()
call, or contact the remote system administrator to obtain access
to the program and restart the program.
- RPC: Program⁄version mismatch; low version = version,
high version = version, version, version
- Check for the correct remote program number and version in the prognum and versnum parameters
of the callrpc() and restart the program.
- RPC: Procedure unavailable
- Check for the correct procedure number in the procnum parameter
of the callrpc() call and restart the program.
- RPC: Server can't decode arguments
- Check for the correct XDR routine in the inproc parameter
of the svc_freeargs() call and restart the program.
- RPC: Remote system error errcode
- Use the system error code displayed in this message and the list
of system error codes in z/OS Communications Server: IP Sockets Application
Programming Interface Guide and Reference to determine the cause of the error and inform
the remote system administrator.
- RPC: Unknown host
- Check for the correct host ID in the host parameter
of the callrpc() call and restart the program.
- RPC: Unknown protocol
- Check for the transport protocol in the -s transport parameter
of the RPCGEN command and verify that both TCP and UDP are specified
in the /etc/protocol directory. TCP and UDP are the supported transports.
A sample copy of the /etc/protocol directory is shipped in the /usr/lpp/tcpip/samples/protocol
directory.
- RPC: Port mapper failure
- Check that the tcpip.SEZAINST(ETCRPC) data
set contains an entry for the portmapper procedure name and restart
the program.
- RPC: Program not registered
- Check for the correct program number in the prognum parameter
of the svc_register() call. This parameter specifies the program
number to be registered.
- RPC: Failed (unspecified error)
- Contact the IBM® Software
Support Center.
- RPC: default; sl=value, s2=value, message, message
- Contact the IBM Software
Support Center.
See Additional information about remote procedure call (RPC) messages for
more information about tcperror return codes. For more information
about the RPC and XDR protocols, see the Sun Microsystems publication, Networking
on the Sun Workstation: Remote Procedure Call Programming Guide.
Module
Procedure name
clnt_sperror