TSO interactive execution
File-AID/Batch functions can be executed interactively at your terminal while you are logged on to TSO. Input control cards can be keyed in at the terminal, and print output can be viewed at the terminal immediately. When File-AID/Batch is executing, it runs in TSO foreground mode. Split screen, PF keys, and scrolling are disabled. If output exceeds the last line of your terminal, three asterisks (***) appear to indicate more output is pending. Press Enter whenever the three asterisks are shown to continue processing. TSO interactive execution of File-AID/Batch applies when you do either of the following:
Use online File-AID option 3.8 (Interactive utility). For more information, see File-AID/MVS Online Reference.
- Invoke optional CLIST FABATCH.
File-AID/Batch recognizes when it is executing under TSO. All output is formatted as if PARM=TSO was specified. (See TSO Execution Parameters.)
When accessing PDSs for update under TSO, either the MEMBER or MEMBERS parameters should be used to specify the member(s) to be opened for update. The UPDATE function usually requires that control card input be provided in a data set. You cannot enter the UPDATE function at an interactive prompt.
TSO screen format
Screens that are displayed when File-AID/Batch is executed in TSO contain the heading shown in the following figure Line 1 gives the File-AID release level and the release date of the installed product. Line 2 prompts you to enter a control card with the statement:
This statement is displayed after each control card is entered and processed.
File-AID TSO Entry Screen
Control card entry
When executed in the TSO environment, you can optionally supply a control card input file, or you can key in control cards at your terminal. If you do not supply a control card input file, File-AID/Batch prompts you to enter a control statement.
Control statements should follow all standard File-AID/Batch coding rules, except that the dataset identifier ($$DDxx) is optional. File-AID defaults to DD01 if no dataset identifier is entered.
All functions require at least one input dataset. Although File-AID/Batch can access 100 data sets in TSO mode, you must explicitly allocate and free any data set other than DD01 or DD01O. The dataset identifier ($$DDxx) is required only when any data set other than DD01 is accessed.
If a coding error is found, File-AID reports the error on your screen and asks for re-entry. For example, if you enter:
a message is displayed on the screen, echoing your input, describing the error and prompting you to reenter the control card as follows:
1...5...10...15...2
INVALID LENGTH OR OPERATOR IN IF, CHECK DATA STARTING IN COLUMN 19
....ENTER NEXT FUNCTION OR END
If the control card you entered is still visible on the screen, you can overtype your control card to correct it and then press Enter. File-AID then continues processing as if no error had occurred.
Stopping processing
To stop processing during entry of control statements:
Press the Attn or PA1 key. File-AID then displays the message:
REENTER LAST LINE OR CANCEL- Enter CANCEL to stop the function.
To stop an executing function before it completes processing:
Press the Attn or PA1 key. File-AID displays the message:
ABOVE FUNCTION ENDED ON ATTENTION KEY- Either enter another function, or enter END to close all data sets and stop execution.
Continuing processing
By default, File-AID prompts for the next input line after parameter entry by displaying the message:
This message is displayed whether or not a comma followed the last entered parameter. Execution can then be started by entering GO.
To bypass the message, enter ,GO (including the comma) after the last parameter on the control statement as follows:
In this example, File-AID executes the DUMP function immediately after you press Enter.
Related topics