PlcShellSkip (FUN)
FUNCTION PlcShellSkip : RTS_IEC_RESULT
Skip a number of blocks in the output.
If a Command Handler sends a huge amount of output, it might be necessary, that this output is splitted into several blocks by the communication layer. When this happens, the communication layer will discard everything, but the current block from the output and recall the Command Handler several times.
To avoid this, an intelligent Command Handler can generate only the currently necessary block of output. For this, it needs to “skip” all blocks, which are already sent, by calling this function. Then it should write only that much data, that they fit into one block and call PlcShellSetEof() when it is finished. RETURN: Returns the runtime system error code (see CmpErrors.library)
- InOut:
Scope
Name
Type
Return
PlcShellSkipRTS_IEC_RESULTInput
iBlockIDDINT