Invocation¶
The Invocation section of the Altair SLC Hub portal is used to view and manage the asynchronous on demand execution of programs.
Dashboard¶
The Dashboard page displays the most recent asynchronous executions with the list of submitted jobs, used programs, and favourites.
For the asynchronous jobs, you can click Expand or Expand All to expand the lists and display the job info, results, and history. From here, you can use the following options:
- Webout: Displays the parsed and raw results.
- Text Encoding: Allows you to select the text or character encoding.
- Download: Downloads a copy of the webout or log file.
- Open in new tab: For supported files, opens the job in a new tab.
By clicking more (...) to the right of each job, you have the following options:
- View program: Displays the program detail, run program info, and execution history.
- Add job to/remove job from favourites: Adds or removes the job from favourites.
- Add program to/remove job from favourites: Adds or removes the program from favourites.
- Re-run: Re-runs the job.
- Cancel: Cancels the job.
- Delete: Confirms the deletion of the selected job.
For the recently used programs, you have the following options:
- View history: Displays the History page with the list of programs that have been executed asynchronously.
- Run: Starts the program execution.
- See All: Displays all the favourite programs on the Programs page.
Programs¶
The Programs page displays the list of programs that have been deployed.
You can filter the programs listed by category and favourites.
Clicking a program displays its details and execution history. You can also modify the program's parameters before running it via the Run Program tab.
For each program in the Programs page, you have the following options:
- Add to favourites (star button): Adds the program to your favourites.
- Categories: To limit the list of programs shown, select any of the category labels next to the Run button.
- Run: Displays the Run program dialog box, from which you can start to execute a program, as shown below.
Running a program¶
To run a program:
- Click the Run button.
- In the dialog box, provide the necessary information in the Program Parameters section.
Note that required inputs are marked with
*. - Click Next to proceed. Alternatively, click Reset to undo the changes.
- In the Execution options section, enter the job's label.
- To receive an email when the job finishes or fails, select the appropriate checbox.
- Click the Run button to save the changes and submit the job.
Viewing the results of the program execution¶
In the Programs page, a program recently executed also displays the date and time the job was submitted and the status of the job itself. You can click the View Results button to access the actual results.
In the Webout section, you have the following options:
- Parsed/Raw: Displays the parsed or raw results.
- Text Encoding/Character Encodings: Allows you to select the text or character encoding.
- Download: Downloads a copy of the webout.
- Open in new tab: For supported files, opens the webout in a new tab.
In the Log section, you have the following options:
- Details: Displays the log details.
- Text Encoding/Character Encodings: Allows you to select the text or character encoding.
- Download: Downloads a copy of the log.
- Open in new tab: For supported files, opens the log in a new tab.
History¶
The History page lists all programs that have been executed asynchronously.
All of the successful executions are marked with a green checkmark.
You can filter the history listed by program, state, favourites, and dates submitted and updated. To save an active filter, you can click Save Filter then enter a unique name in the dialog box that displays.
In the Filter section, you can also perform the following options:
- Saved Filters: Allows you to select and display the saved filter.
- Edit: Allows you to make updates to the selected saved filter. You can then either click Done to save the changes or the Delete icon to confirm the deletion.
To view more information, you can select a label or click the Expand or Expand All icon.
In the Job Results tab, you can view the results and perform the following actions:
- View program: Displays the details of the program in the Programs page.
- Re-run job: Re-runs the job.
- Add to favourites: Adds the job to favourites in the Dashboard page.
In the Execution Log tab, you have the following options:
- Open in new tab: For supported files, opens the history in a new tab.
- Download log: Downloads the log.
- Text/Character encoding: Allows you to select the text or character encoding.
In the Advanced Info tab, you can view the details of the job history and additional info.
By clicking more (...) to the right of each history, you have the following options:
- View program: Displays the details of the program in the Programs page.
- Add job to/remove job from favourites: Adds or removes the job from favourites.
- Add program to/remove job from favourites: Adds or removes the program from favourites.
- Re-run: Re-runs the job.
- Cancel: Cancels the job.
- Delete: Confirms the deletion of the selected job.