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.
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. |