Siemens S7 appendix NDR Error Status, LEN Output INT

Programming FCs (Functions) and FBs for S7 Ethernet CPs

Parameter	Declara-	Type	Possible		Remarks
	tion		Values
LEN	OUTPUT	INT	On ISO	Specifies the number of bytes accepted from
			Transport and	the Ethernet CP and entered in the data area.
			ISO-on-TCP:	S Note the block type:
			1,2...8192	–	S7-300
			On UDP:		With older versions of FC AG_RECV (up
					to V3.0), the data area is always
			1,2...2048		restricted to a maximum of 240 bytes.
					The current versions allow up to 8192
					bytes (2048 bytes for UDP).
				–	S7-400
					With FC AG_RECV, the data area is
					restricted to a maximum of 240 bytes.

Condition Codes

The following table shows the codes formed by the DONE, ERROR and STATUS parameters that must be evaluated by the user program.

Note

For entries coded with 8FxxH in STATUS, refer to the information in the STEP 7 Standard and System Functions reference manual. The chapter describing error evaluation with the RET_VAL output parameter contains detailed information.

To find out which SFCs are used and are relevant for error evaluation, display the properties dialog of the FC described here in the “Calls” tab.

Table 5-3 AG_RECV / AG_LRECV Codes

NDR	ERROR	STATUS	Meaning
1	0	0000 H	New data accepted.
0	0	8180H	There are not yet any data available.
0	0	8181H	Job active.
0	1	8183H	No configuration or the ISO transport service has not yet started
			on the Ethernet CP.
0	1	8184H	System error (the source data area is incorrect).
0	1	8185H	Destination buffer (RECV) is too short.
0	1	8186H	ID parameter invalid.
			ID != 1,2....16 (S7-300).
			ID != 1,2....64.(S7-400)

SIMATIC NET NCM S7 for Industrial Ethernet	165
C79000-G8976-C129–06