> For the complete documentation index, see [llms.txt](https://docs.editran.onesait.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.editran.onesait.com/documentacion-editran/open-v5.3-en/windows/gestor_transmisiones.md).
# Transmission Management
Editran/GT (Transmission Manager) allows editran transmissions to be managed in order to carry out Emissions and/or Receipts of editran Presentations efficiently and unattended.
Editran/GT is highly configurable to achieve maximum flexibility; it includes a configuration dialog that allows defining emission windows, search intervals, subsequent processes, retries, etc.
In addition, for emissions, editran/GT looks for the files that are registered in the editran/G Presentations in order to transmit them, so that when an emission file associated with an editran/G Presentation appears and it is within the selected time window, the emission of that Presentation will be triggered automatically. This is very useful for automating data transmission when they exist, increasing system efficiency.
Another equally important aspect is the existing connection between editran/GT and the rest of editran. Editran/GT has been designed as the editran Transmission Manager and as such is capable of reading the profiles of editran/G and editran/P; this makes configuring editran/GT easier and allows querying editran characteristics, such as presentation status, which can help determine the reason for a possible incident in an editran send or receive.
Finally, note that there is a log file and a status file specific to editran/GT which, together with the log and status files already existing in editran/P and editran/G, form a complete set of important information both on successful transmissions and on incidents in any of them
## Description and functionality
Editran/GT includes both very detailed configuration functionality for scheduling Emissions and Receipts, as well as the possibility of querying information on transmissions that have taken place (files sent, start and end date-time of the transmission, current status of each transmission...), and transmissions that have ended with some kind of error.
## editran/GT service
Editran/GT runs as a Windows service on operating systems that support Services. It is necessary to install the service on the system and configure it to start automatically or manually, as decided.
**Service installation**
To install the service, if it is not already installed, run the following command as administrator from the Command Prompt (cmd) located in the editran installation directory:
`editrangtserv -install`
With this command, editran/GT is installed as a system Service, started by the *Local System Account* and with Startup type *"Manual"*.
To verify that the service has been installed correctly, you must open the services window and look for the Service name **EDItranGTServ**:
It can also be installed with dependency on the editran service with the following command:
`editrangtserv -installdepend`
The dependency on the editran Service is checked in the Dependencies section.
**Service configuration**
By double-clicking or choosing the Properties option from the context menu on the Service **EDItranGTServ** we access the service configuration parameters:
To modify the startup type so that it starts automatically with the server, select the **Automatic Startup Type**.
To modify the service logon user, select the tab **Log On**:
Select the option **This Account:** and assign the desired local or domain user.
**Delete the service**
To delete the EDItranGTServ service, run the following command from the editran installation directory from the Command Prompt (cmd)
`editrangtserv -remove`
This command removes EDItranGTServ from the list of services installed on the system.
***Important**: If you have Windows Vista, 7, 8, 2008 or 2012, you must run Command Prompt (cmd) with the "Run as Administrator" option in the context menu in order to delete the service.*
It is recommended to close the Windows services window before running the command.
## editran/GT menu
Once editran/GT has started, the application **EDItranGT Menu** (executable file **menugt.exe**), which will open an editran/GT icon in the Notification area of the Windows taskbar:
Right-clicking the editran/GT icon brings up the context menu with the available options:
The Menu/GT depends on the Service, that is, Menu/GT requires the Service to be started in order to open; if it is not, the following message will be displayed:
In turn, the editran/GT Service can be running without the Menu/GT being open.
If you try to open Menu/GT when one is already open, the following message will appear:
### Service configuration
By selecting the 'Configuration'->'Service' label from the editran/GT menu you can consult and define the following options:
In order to modify these values you must have started the EDItranGT Menu application (executable file menugt.exe), as administrator.
#### Search interval
Every so often, editran/GT queries all Associated editran/G Presentations looking for those that match the configured criteria, to request an Emission or Reception from editran.
That file search interval is configured by assigning a value in the 'File search interval' field.
In the example, 60 seconds have been defined, that is, every minute editran/GT will look for the Presentations that meet the Emission and/or Reception conditions and will request editran to execute the transmission.
This configuration is stored in the following Windows registry key:
`HKEY_LOCAL_MACHINE\\SOFTWARE\\INDRA\\EDItranGT\\Intervalo`
And on 64-bit operating systems:
`HKEY_LOCAL_MACHINE\\SOFTWARE\\Wow6432Node\\INDRA\\EDItranGT\\Intervalo`
#### Autostart
Editran/GT can be installed as an automatic start service; in this case editran/GT will start when the machine starts.
However, editran/GT may be running and the search for Presentations to Emit or Receive may not have started.
If we want the search for Presentations to Emit or Receive to start at the same time as the editran/GT service starts, we must check the 'Autostart' flag in the configuration dialog.
By default, the configuration is a **Search interval** of 60 seconds and **Autostart** disabled. When a change is made in that configuration, it is saved in the following Windows registry key:
`HKEY_LOCAL_MACHINE\\SOFTWARE\\INDRA\\EDItranGT\\AutoStart`
On 64-bit Operating Systems it is saved here:
`HKEY_LOCAL_MACHINE\\SOFTWARE\\Wow6432Node\\INDRA\\EDItranGT\\AutoStart`
#### Alerts program
It is possible to configure Editran/GT to invoke a customer-specific program each time a presentation ends in the "Error without retries" state.
To do this, that program must be included in the "Alerts program" section:
When a change is made in that configuration, it is saved in the following Windows registry key:
`HKEY_LOCAL_MACHINE\\SOFTWARE\\INDRA\\EDItranGT\\ProgramaAlerta`
On 64-bit Operating Systems it is saved here:
`HKEY_LOCAL_MACHINE\\SOFTWARE\\Wow6432Node\\INDRA\\EDItranGT\\ProgramaAlerta`
***IMPORTANT**: If you have Windows 8, Server 2008 or later, it is necessary to add the user or user group that will use the editran/GT menu in the Permissions section of the **Windows Registry** in order to modify the configuration stored in it.*\
*To do this, with an administrator user on the machine, right-click the EDItranGT key, click Permissions, click the Add button and add the user or user group that will operate with editran, setting the Full Control permission.*
### Associated presentations configuration
By selecting the 'Configuration'->'Presentations' label from the editran/GT menu a dialog is shown with the list of registered associated presentations in editran/G.
We can expand the list to see all editran/G presentations:
We also see from the drop-down list the editran/G Presentations that are associated with editran/GT. In the example, the Presentation **WIN-GT-02** from editran/G is associated only in Emission with editran/GT.
editran/G presentations that are not associated with editran/GT will not be transmitted automatically; they must be transmitted manually using editran menus and commands; only the Presentations associated with editran/GT will be transmitted automatically.
If we want to assign an editran/G Presentation to editran/GT, we first select it in the drop-down list and then check the 'Associated Presentation' flag:
A window will appear asking whether you want to Associate the Presentation:
In this case we are associating the Presentation **WIN-GT-02** to editran/GT. Clicking the 'Yes' button will associate the Presentation and we will see the following dialog:
A Presentation associated with editran/GT must be used to request from editran Emissions, Receipts, or both by selecting at least one of the two flags:
* Emission: 
* Reception: 
When selecting or clearing the 'SEND' or 'RECEIVE' flags, the parameters associated with Emission or Reception respectively will be shown or hidden.
#### Emission Parameters
Emission presentations, in addition to being able to be scheduled for sending through a time window, are emitted only when emission files exist.
**Emission Files**
Editran/GT reads directly from the editran/G profiles and displays the first file that is registered in the profiles of the selected editran/G Presentation:
The presence or absence of the emission file (which may contain wildcards) is what will trigger the Emission request. That is, if a Presentation is configured to Emit several files, the emission will not start until the expected file appears; if there is a time window, not only must the file appear, it must also be within the [time window](#ventana-horaria).
Even though the first Emission file is displayed, editran/GT reads and will wait for the appearance of any of the other defined files.
It is a read-only parameter, it cannot be modified from editran/GT and is presented for informational purposes only; if you want to modify it you will have to use the editran/G Menu.
**Post-Emission Process**
To prevent a successfully transmitted Emission from being sent again, the emission file must disappear; this can be achieved in two ways:
* Delete the successfully transmitted Emission files.
* Move the successfully transmitted files to another directory (and rename them if desired).
* Run process.
* **Delete files from the emission source directory**
If the option **Delete**, is selected, the emission files **transmitted** by editran will be deleted after successful transmission.
* **Move the files from the emission source directory to the directory**
The directory to which we want to move the emitted files must be specified and, if desired, the emitted file can be renamed by adding the System Date-Time by selecting the check for **Rename** **the emitted file by adding the System Date-Time**. If the check box is not selected, files with the same name will be overwritten.
* **Run process**
These batch programs will be provided by the user, located in the editran installation directory, and are executed after emitting files; they must also include moving or deleting the transmitted files.
By default, when editran finishes a transmission successfully, but the emitted files could not be moved or deleted correctly, editran/GT leaves that presentation as finished, which may eventually cause the files to be sent several times.
If you want editran/GT to leave the presentation as finished with error in this case, you must add in the Windows registry, in the EDItranGT key, a **String value** (REG\_SZ) with value **1** called **ErrorEnPosterior**.
The Windows registry key for editran/GT is located at:
32-bit Operating Systems:
`HKEY_LOCAL_MACHINE\\SOFTWARE\\INDRA\\EDItranGT\\`
64-bit Operating Systems:
`HKEY_LOCAL_MACHINE\\SOFTWARE\\Wow6432Node\\INDRA\\EDItranGT\\`
**Time Window**
It is possible to set file sending by editran to one or several specific times. That is, even if a file exists at a given time, we can parameterize it so that it is not sent when it appears, but rather sent in a time period called **Time Window**.
If you want to use the feature **Time Window** of editran/GT, you must select the check box shown below:
To configure the Time Windows, click the button **Window Query**. The following dialog will appear:
* **Add an Emission Time Window**
To add a new *time window* we must first fill in the Hour-Minute-Second *'From'* and *'To'*. For example, if you want to add a time window that goes from 1:30 in the morning to 06:45, you would define:
By clicking the button *Add* we will see that a new *time window* has been added to the list:
More Time Windows can be added if desired:
To save and return to the configuration dialog, press the button *OK*.
* **Modify an Emission Time Window**
To modify an *time window* existing one, first we must select the Window to modify in the list and then modify the 'From' or 'To' configuration as desired.
For example, to modify the window created above so that it ends at 6:45 in the morning, select it and set it to end at 8:30:
Finally, click the button *Modify* to change the parameters of the *Window:*
To save and return to the configuration dialog, press the button *OK*.
* **Delete an Emission Time Window**
Select the time window you want to delete and click the *'Delete'*. After accepting the operation through a confirmation dialog, the *window* will be deleted from the list.
Keep in mind that if the list has no *time window* and the flag *'Use time window*' is checked, that Presentation will never be emitted.
To save and return to the configuration dialog, press the button *OK*.
* **Only One Emission per Emission Time Window**
It may be desirable to request an emission from editran for each *Time Window*, even if there are new files to be emitted.
For example, if in the editran/G Presentation **WIN-GT-02** we want it to be sent at night (from 01:00:00 to 06:45:00, for example) and only do it once in that Time Window, we will check the option *Only one Emission for each Time Window*:
* **Advanced Options**
In the advanced options of an emission, 2 parameters can be specified
* Day on which it is to be sent (Monday, Tuesday, .... Sunday)
* Day of the month number on which it is to be sent (1,2,3.....30/31)
It is important to note that if there is a schedule that specifies the "day of the week" and the "day-of-month number", the emission will only be carried out when it is met that the selected "day of the week" is also the day-of-month number.
To save and return to the configuration dialog, press the button *OK*.
**Retries**
There is an option in editran/GT to retry an Emission by editran that has ended with an error. In addition, you can indicate the number of retries you want to perform.
The parameter "Interval between Retries (minutes)" sets how often we want to execute the emission request again, in the event that there has been an error during the initial request.
In this case, Editran/GT will retry the emission 1 time, will wait for editran to finish its own retries (defined in the session configuration in the editran/P Menu), will wait 5 minutes to retry again, and so on until 2 more retries.
It may happen that a Presentation could not be sent after retrying the indicated number of times. In that case the presentation will move to a state *'Finished with Error. No Retries'* (see section [Status Table](#tabla-de-estados)), a presentation that is in that state is considered to require at least one manual operation to achieve emission (configuration failure, prolonged network problem, etc.); for that reason this Presentation will not be emitted again from editran/GT until the editran/GT Presentation status has been manually initialized using the button *Initialize Presentation* (see section [Status Query](#consulta-de-estado)).
**States**
The configuration dialog shows the emission status of a Presentation associated with editran/GT, as well as the date and time at which that status was assigned:
For more information about editran/GT statuses, see chapter **4.4 Status Query**.
#### Reception Parameters
Section of the configuration dialog belonging to the Reception parameters of editran/GT:
**Time Window**
To configure the Reception Time Window(s), click the 'Window Query' button within the Reception parameters in the Query dialog.
The following Time Window dialog will appear:
See the description of Time Windows in section [Time Window](#ventana-horaria).
One difference between the *Time Window* of **Emission** and **Reception** is that its use in Emission is optional and in Reception it is mandatory, since in the Emission request it can be done when the Emission file appears; however, in Reception there is no such possibility.
**Retries**
See the description of retries in the section [Retries](#reintentos).
**States**
See the description of States in the sections [States](#estados) and [Status Query](#consulta-de-estado).
### Start search / End search
Editran/GT has two operating modes:
* **Searching Transmissions to Emit/Receive**: In this state editran/GT is searching for Presentations to Emit and/or Receive, and configuration changes to editran/GT are not allowed.
> The icon shown in the taskbar is: 
* **Not searching Transmissions**: In this state editran/GT will make no emission or reception requests to editran, and configuration changes are allowed.
> The icon shown in the taskbar is: 
The search cannot be ended while there are pending transmissions (in transmission, retrying, etc.), and the following message appears:
The log message will be:
### Log Query
Editran/GT stores all the operations it performs in a Log file so that they can be consulted later.
Along with the [status file serves](#consulta-de-estado) as diagnosis and verification of transmissions scheduled and sent or received by editran.
The Log file is not cyclic, that is, it grows in size as transmissions are carried out, which is why it is recommended to replace that Log file from time to time. To do this, the editran/GT service must be stopped and the Log file (if you want to keep it), located in the editran installation directory and called **editrangt.log**.
To view the Log file, right-click the editran/GT icon and select the menu **Log Query**:
> 
The following window appears:
The Log dialog is very similar to the editran Log dialogs, making consultation easier.
At the top are the parameters indicating which section of the Log file is to be displayed:
* **Presentation**: A specific presentation can be selected to view its Log or the literal *\,* which will display the Log of all Presentations associated with editran/GT.
* **Direction**: Emission or Reception must be selected depending on the direction whose Log you want to view.
* **Date**: This is the date **from** which you want to view the Log (day/month/year). By default the current date appears, therefore if this value is not modified the Log of the operations performed that day will be displayed.
* **Time**: This is the time **from** you want to view the Log (hours:minutes:seconds). By default 00:00:00 appears
Once the above parameters have been filled in, click the button *"Show Log"* and the list will be filled with all entries in the Log file that meet the previously selected requirements:
To exit the dialog, click the button *"Exit"*
### Status Query
Editran/GT builds a status file where it stores information about the status of all Presentations associated with EDITRAN/GT, as well as the date and time at which it was changed to that status.
The information on editran/GT statuses is complementary to the information on editran/G statuses and serves both to have an overall view of the current status of transmissions, and to see which transmissions could not be completed successfully.
These statuses are stored in the file editrangt.sts for emissions, and editrangtrec.sts for receptions.
To check the statuses of editran/GT, a status query dialog is used. To obtain it, right-click the editran/GT icon and select the option **Status Query**:
The following dialog will appear:
Emission or Reception must be selected in the drop-down list *'Direction'*
And all Applications associated with editran/GT in the selected direction will appear, along with the status of each Application and the date-time when it was modified:
From this same dialog we can change the reception status of editran/GT of the selected Presentation by clicking the button *Initialize Presentation*. For example, this may be useful for editran/GT to try again to transmit a Presentation that was in the state '*Finished with Error. No Retries'*.
#### Status Table
The states in which an editran/GT Presentation can be are as follows:
| Status | Description |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| Initialized | The Presentation associated with editran/GT is not carrying out any transmission. |
| Transmitting | The presentation is being transmitted by editran. |
| Finished with Error | The presentation has been launched by editran/GT and has ended with some error. |
| Retrying | The presentation has ended with an error, but it is configured with retries and is currently retrying the operation. |
| Finished with Error. No Retries | The presentation has ended with an error and either no retries are configured or they have been exhausted. |
| Transmitted | The transmission of the Presentation has been launched by editran/GT and has been transmitted successfully. |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.editran.onesait.com/documentacion-editran/open-v5.3-en/windows/gestor_transmisiones.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.