Pascal return codes

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.