Calling a Batch Task (Magic xpa 3.x)
The Browser task supports calling Batch tasks that send output to the I/O requester, selected from the I/O repository’s Media column. When you call and send a Batch task that produces an HTML form or a Merge form to an I/O requester, the batch output is displayed in a browser window as defined in the Call program, Call Task, or Call Exp operation's Destination frame property.
Any destination frame defined in subsequent Call operations to other Batch tasks are disregarded. Only the destination frame defined in the Call operation to the Browser task’s Batch task is used.
A program can return content in one of several ways:
-
Form Output to an I/O defined with a Requester type.
-
Calling the File2Req or Blob2Req functions.
Batch Within the Current Context
The Batch task that is invoked by a Call Program, Call Task, or Call Exp operation is run within the active context of the calling task. This means that all the context resources, such as variables, task tree, global parameters, memory tables, and transaction, are available to the called Batch task. Any modification made to the context resources will be kept in the context when the Batch task is completed.
Modeless Window
The window of the Batch task's result output cannot be a modal window, which does not let the user select another window without first closing the selected window. It is always opened as a modeless window, which lets the user select another window without having to close the selected window.
Result Window Out of Context
The result page that opens when the Batch task ends is from the originating context.
Output from Nested Batch Tasks
The output to the requester can be produced by the immediate Batch task that is called from the Browser task, and also by a Batch task that is a descendant of the first Batch task called. The output is returned to the client only when the immediate Batch task is completed.
No Output, No Window
If you run a batch program that does not produce output to the requester, a page does not open.
