pdcomm::seedFormattedProgramQuery

Function

Adds or replaces a program in the equipment's formatted program store.

inline void seedFormattedProgramQuery(GemEndpoint &endpoint, const SecsItem &id, const std::string &model, const std::string &softwareRevision, const std::vector<GemFormattedProgramQueryCommand> &commands)

Declared in: #include <pdcomm_gem_formatted_program_queries.hpp>

This is an upsert into the same store that putFormattedProgramStore() changes. The program is validated as a complete S7F26 answer before it is stored.

Parameters

Name	Description
endpoint	Equipment endpoint with formatted program requests configured.
id	PPID: a non-empty ASCII or Binary item of at most 120 bytes.
model	MDLN, ASCII, at most 20 bytes.
softwareRevision	SOFTREV, ASCII, at most 20 bytes.
commands	Program commands in order.

Notes

• Throws pdcomm::Error: PDCOMM_INVALID_STATE on a host or without configuration; PDCOMM_INVALID_ARGUMENT for invalid input; PDCOMM_LIMIT_EXCEEDED when the store, command, parameter, or SECS-II item limits are exceeded.