PdcommGemFormattedProgramTransferOptions
Struct
Limits for the S7F23/S7F24 transfer service.
typedef struct PdcommGemFormattedProgramTransferOptions { ... } PdcommGemFormattedProgramTransferOptionsPass this structure to pdcomm_gem_configure_formatted_program_transfers(). The command and parameter limits apply to programs that are sent and to programs that are received.
Members
max_commands
Field
Largest number of process commands in one program.
size_t max_commandsmax_history
Field
Number of completed transactions remembered to reject replays; the oldest is discarded first.
size_t max_historyMust be nonzero.
max_parameters_per_command
Field
Largest number of PPARM items in one command.
size_t max_parameters_per_commandmax_pending
Field
Largest number of sent S7F23 messages awaiting S7F24; must be nonzero.
size_t max_pendingmax_received
Field
Largest number of received S7F23 messages awaiting a reply; must be nonzero.
size_t max_receivedA primary leaves this count when it is answered, or when its HSMS session ends (deselect or disconnect), because it can no longer be answered.
max_results
Field
Number of completed transfer outcomes the service retains; the oldest is discarded first.
size_t max_resultsMust be nonzero.
max_total_parameter_bytes
Field
Largest sum of the encoded sizes of all PPARM items in one program, in bytes.
size_t max_total_parameter_bytesmax_total_parameters
Field
Largest number of PPARM items in one program.
size_t max_total_parametersreserved
Field
Reserved; must be 0.
uint32_t reservedstruct_size
Field
Size of this structure in bytes; at least sizeof(PdcommGemFormattedProgramTransferOptions).
size_t struct_sizeversion
Field
Options layout version; must be #PDCOMM_GEM_FORMATTED_PROGRAM_TRANSFER_OPTIONS_VERSION.
uint32_t version