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