Code identification

These commands are designed for code denoting within the main module %IMPLEMENTATION or %USER_MODULE sections; the code denoted this way is to be inserted into the target user module in each generating unless it has been already included.

The text will be inserted into the place to which it is generated from the driver; the place can be found as per the longest from the previous three lines generated (preceding the %EMBED_CODE command) or in case %EMBED_CODE contains the +(plus) option the longest from the three lines following %EMBED_END; if the reference line is not found within the user module, the embed code is not added and an error message is displayed.

The embed code is denoted by an identification text (see parameter <id>) that must be a part of the generated text and as per which the existence of the embed code within the user module will be identified, therefore, the identification should be unique; it's recommended to place identification text into the first line of the embed code; if the identification is also found at the last line of the embed code, it is used to detect position of the embed code inside user module; the parameter should be human readable because it can be also displayed in the message in case, user code is not found in the user module;

The optional ! parameter (exclamation mark) will cause the embed code comparison/substitution in every generating action, the first and last line is found within the user module, the whole content is deleted and replaced by a newly generated embed code; advantages: this cannot be changed by the user, the content can be modified as per generating parameters.

The optional msg parameter (text until the end of the line) is displayed in modal dialog in case of generating provided the embed code is inserted or updated into the relevant module; if this parameter is not specified, no message is displayed.