3. Viewing and Printing Output
3.3 Querying the Output Window
Hide or unhide tasks
Select one or more files and click the Hide button. To select multiple adjacent files, use Shift+click. To select multiple non-adjacent files, use Ctrl-Click. Hiding output changes the status of the selected files to STORED and removes the listing from the viewable list. To hide all listings in this window, request the OLDPRTS job.
To display hidden files, you must use the Query function and query for the STORE status. If after querying, you select a file and click Hide, its output function will be changed to LOG.
If the Hide Files on the Output Window option was not assigned to you by your Applications Manager administrator, you will not be able to use the Hide button. For more information on user options, see topic 3.2.1 Setting User Options in the Administration Guide.
Refresh the display
Click the Refresh button. When you first open the Applications Manager client, tasks that have completed with a LOG status will be available for viewing without running a query on the Output window. If other tasks complete while you have a client session open, they will not
automatically be added to the Output window. Refresh the display to see them.
output Select a task and click the information on printing output, see topic 3.5 Printing, FTPing, and Emailing Print button or one of the Print icons. For more Output Files.
50 Chapter 3: Viewing and Printing Output
3.3 Querying the Output Window
To search for specific tasks in the Output window, click the Query button. You can query by jobs, process flows, requestors, output functions, output devices, agents, start times, and run IDs.
If you are looking for a specific task and the number of tasks listed in the Output window is overwhelming, or you wish to view output from tasks which are not listed by default, you can run a query on the Output window.
Procedure
To perform an output query:
1. Click the Query button on the Output window.
Applications Manager displays the Output query window shown in Figure A. 2. Select search criteria for your query.
You can use any combination of query criteria available in the Output query window. The Output query window fields are described in Table A.
To query by one or more objects, enter values in each object’s field by doing one or both of the following:
•Type in names of the objects separated by commas.
•Select from a list of objects by clicking on the object icon at the end of the field.
Table A. Output query options
Field Description
Jobs Searches for any task assigned to the specified job(s), including tasks that ran the job under an alias name.
To query for a task run under an alias, enter the alias name.
Applications Manager Version 8.0 User Guide 51
Process Flows Searches for tasks that are part of the process flow(s). The process flows themselves are not returned.
Agents Searches for any task run on the specified agent(s).
Output Devices Searches for any task assigned to the specified output device(s). Requestors Searches for any task run by the specified requestor(s).
Output Function Searches for tasks based on the output function set for the job at run-time. There are three statuses:
•LOG: The output is available for printing, but has not been printed. Outputs with this status appear on the Output window list by default.
•PRINT: Same as LOG, but output is sent to output devices as well.
•STORE: You must query to see output files with this status. System output files are typically stored.
From start time
To start time These fields accept date/time information. If the option is selected, the From start time and To start timeCurrent day fields will be inactive.
Run ID This field references the unique number (format: 1320.00) assigned to each task by Applications Manager. When using this field, include the decimal value where appropriate. Decimal values at the end of Run IDs indicate that tasks have been restarted. Every task has .01 added to its Run ID each time it is restarted. Current day The default is to query by the current day. All tasks run from
midnight to the current time will be included. If you save a query with this option checked, it will be applied each time you run the saved query.
The date and time of the current day are saved as an offset from the current time. That means that if you save a query for tasks run in the last two days, it will always run a query for the tasks in the last two days. There is no way to save a query from a specific date.
If you uncheck this option, the From start time and To start time fields become active. You then can enter specific dates and times for the query.
Field Description
52 Chapter 3: Viewing and Printing Output
3. You may select a default sort order for the query by selecting a Sort option. The sort order can be overridden from the Output window by selecting a different column name.
4. You may also optionally save this output query to use later by entering a name in the Filter name drop-down box. The output query will be saved when you click OK. Saved Output queries can be recalled from the Filter name drop-down box for History queries, Output queries, and filters of the Backlog and History.
5. Click OK.
Applications Manager displays a small animated window as it processes the query. Once the query is processed, Applications Manager displays the results in the Output window.
Using the Object Assignment Windows
When you click on an icon at the end of one of the applicable fields, Applications Manager displays the object assignment window where you can pick one or more objects to use in an output query. The windows will list only the objects to which you have user group access. Use the arrow buttons to move objects between the Unassigned and Assigned tables. For more information on assigning objects, see topic 1.3 Working in the Applications Manager Windows.
Use the Other filters field to enter text-based filters.
•You can enter several letters, and all objects beginning with those letters will be included.
•You can use wildcards in the text. You can use the _ wildcard to represent a single character, and the % wildcard to represent an unlimited number of characters.
•You can include negative filters to exclude tasks from the search using the ! character. For example, entering !AW% will exclude tasks with the letters AW together in their name.
Any text entered in the Other filters field will be included in the appropriate field on the Select filters window.
Use the Search field to query the Unassigned table. You can apply the search criteria to the Assigned column as well by unselecting the Show all assigned option.
Applications Manager Version 8.0 User Guide 53
Viewing Query Results
When you click OK in the Output query window, Applications Manager runs the search and displays the queried results. The Apply Query check box will be checked as shown in Figure C. To clear the query, uncheck the Apply Query box. You can view the queried results again by rechecking the Apply Query box. To apply a saved output query, select it from the drop-down box.
54 Chapter 3: Viewing and Printing Output