z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Pascal return codes

z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference
SC27-3660-00

When using Pascal procedure calls, check to determine whether the call has been completed successfully. Use the SayCalRe function (see SayCalRe) to convert the ReturnCode parameter to a printable form.

The SayCalRe function converts a return value into a descriptive message. For example, if SayCalRe is invoked with the return value BADlengthARGUMENT, it returns the message invalid length specified. See Table 1 for a description of Pascal return codes and their equivalent message text from SayCalRe.

Most return values are self-explanatory in the context where they occur. The return codes you see as a result of issuing a TCP/UDP/IP request are in the range -128 to 0.

Table 1. Pascal language return codes
Return Value Return Code Message Text
OK   0 OK.
ABNORMALcondition -1 Abnormal condition because of CSA storage shortage.
ALREADYclosing -2 Connection is already closing.
BADlengthARGUMENT -3 Length specified that is not valid.
CANNOTsendDATA -4 Cannot send data.
CLIENTrestart -5 Client reinitialized TCP/IP service.
CONNECTIONalreadyEXISTS -7 Connection exists.
ERRORinPROFILE -8 Error in profile data set. Details are in PROFILE.TCPERROR or the //SYSERROR DD file.
FATALerror -9 Fatal error; not valid user parameter (storage key).
HASnoPASSWORD -10 No password is in the RACF® directory.
INCORRECTpassword -11 TCPIP is not authorized to access the data set.
INVALIDrequest -12 Request not valid.
INVALIDuserID -13 User ID not valid.
INVALIDvirtualADDRESS -14 Virtual address not valid.
LOCALportNOTavailable -16 The requested local port is not available.
NObufferSPACE -19 No more space for data currently available. This applies to this connection only; space might still be available for other connections.
NONlocalADDRESS -21 The internet address is not local to this host.
NOoutstandingNOTIFICATIONS -22 No outstanding notifications.
NOsuchCONNECTION -23 No such connection.
NOtcpIPservice -24 No TCP⁄IP service is available.
NOTyetBEGUN -25 TCP⁄IP service not yet begun.
NOTyetOPEN -26 The connection is not yet open.
OPENrejected -27 Foreign host rejected the open attempt.
PARAMlocalADDRESS -28 TcpOpen error: local address not valid.
PARAMstate -29 TcpOpen error: initial state not valid.
PARAMtimeout -30 Timeout parameter not valid.
PARAMunspecADDRESS -31 TcpOpen error: unspecified foreign address in active open.
PARAMunspecPORT -32 TcpOpen error: unspecified foreign port in active open.
PROFILEnotFOUND -33 TCPIP cannot read PROFILE data set.
RECEIVEstillPENDING -34 Receive is still pending on this connection.
REMOTEclose -35 Foreign host unexpectedly closed the connection.
REMOTEreset -36 Foreign host abended the connection.
SOFTWAREerror -37 Software error in TCP⁄IP.
TCPipSHUTDOWN -38 TCP⁄IP is being shut down.
TIMEOUTopen -40 Foreign host did not respond within OPEN timeout.
TOOmanyOPENS -41 Too many open connections exist.
UNAUTHORIZEDuser -43 You are not authorized to issue this command.
UNIMPLEMENTEDrequest -45 TCP/IP request not implemented.
UNREACHABLEnetwork -47 Destination network cannot be reached.
UNSPECIFIEDconnection -48 Connection not specified.
VIRTUALmemoryTOOsmall -49 Client address space has too little storage.
WRONGsecORprc -50 Foreign host disagreed on security or precedence.
ZEROresources -56 TCP cannot handle more connections now.
UDPlocalADDRESS -57 Local address for UDP not correct.
UDPunspecADDRESS -59 Address was not specified; specification is necessary.
UDPunspecPORT -60 Port was unspecified; specification is necessary.
FSENDstillPENDING -62 FSend still pending on this connection.
ERRORopeningORreadingFILE -80 Error opening or reading data set.
FILEformatINVALID -81 File format is not valid.
SAYCALRE* -130 Unknown TCP return code.
* Return codes that are not valid (out of the range -128 to 0) return Unknown TCP return codes when translated using SAYCALRE.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014