HORIZONT TWS/WebAdmin Software for Datacenters The Web Interface for TWS Web-Based Management and Monitoring of TWS Distributed HORIZONT Software for Datacenters Garmischer Str. 8 D- 80339 München Tel ++49(0)89 / 540 162 - 0 www.horizont-it.com 1 1 1 1 1 1 1 1 1 1 1

Topics TWS/WebAdmin Features Getting Started TWS Database Management Plan Monitoring and Management Job Notes Reporting Events and Alerts Miscellaneous Functions

TWS/WebAdmin Features Web Interface to Tivoli Workload Scheduler for Distributed (Unix and Windows) TWS Database Management – composer functions TWS Plan Management – conman functions Event Monitoring Alerting (Email and Custom Alerts) Job Notes Reporting: Customizable reports, charts and graphs, flexible SQL query engine

Getting Started Logging In TWS/WebAdmin Home Page Basic Navigation Help Printing Administration Page

Logging In Launch web browser, enter the name of the TWS Master in the address bar. Enter user name and password

TWS/WebAdmin Home Page

Basic Navigation TWS/WebAdmin display consists of 2 frames Navigation frame on left Results frame on right

Getting Help Clickable Help Link

Online Help Window

Printing from TWS/WebAdmin Click Print

TWS/WebAdmin Administration Page Click link to enter Administration area The user must have Administrator privileges

Administration Home Page Various management, configuration and maintenance options Click here for displaying the WebAdmin system diagnostics

Database Management Database Management Functions Object Definition Lists Common Database Management Actions Using Filters Backups Drafts Advanced Database Management Actions: Text Edit, Export, Dependent Objects

Database Management Functions Create, Modify, and Delete TWS Scheduling Objects Display and Edit object definitions in GUI mode or text mode Save Draft copies of Job definitions Export definitions to files for migration and backups View dependent objects and Notes

TWS Database Scheduling Objects Workstations Workstation Classes Domains Applications Jobs Jobstreams Run Cycles Calendars Resources Prompts Parameter Tables Parameters Event Rules Users

Workstation Definitions Click object name to display definition Action Buttons

Workstation Class Definitions

Domain Definitions

Job Definitions

Workload Application Definitions

Jobstream Definitions

Calendar Definitions

Resource Definitions

Prompt Definitions

Parameter Table Definitions

Parameter Definitions

User Definitions

Event Rule Definitions

Run Cycle Definitions

Common Database Management Actions Click on an object name to display its definition (read-only) Standard Actions: Add, Modify, Copy, Delete Display: Show text definitions (multiple objects can be selected) Copy: Duplicate an existing object Unlock: Unlock a locked object in TWS database

Example: Display Workstation Click workstation name to display definition

Example: Display Workstation

Example: Display Workstation (Text) Select one or more workstations Click Display/Definition

Example: Display Workstation (Text)

<< Year >> Example: Add Calendar Navigation: < Month > << Year >> Click dates to toggle

Example: Modify Job When Modifying a job, the Workstation and Job names cannot be changed. Use the Copy job action instead if you want to change the Workstation and/or Job names.

Example: Modify Job (Confirmation) Comparison of original an new job data (changes highlighted). Backup copy of original job definition is saved by default

Example: Delete Jobstream Select one or more jobstreams Click Actions/Delete

Example: Delete Jobstream Backup copy of jobstream definitions is saved by default

Using Filters Click the Filter action button on any Database List page to display filter options, or the “F” shortcut right next to the corresponding menu item Current filter settings are displayed in the top left corner of Database Lists Click Clear Filter on filter page to clear filter settings Filter settings can be saved, restored, and bookmarked Click Database Filters in the navigation frame to go directly to a filter page

Database Filter Example Click on “F” shortcut to get to the Filter dialog Or click on Filter menu to select “Set Filter” action or directly select an already defined filter from the list bellow

Database Filter Example Select the filtering criteria to get all required objects Use either * or @ as the wildcard character… Both work!

Database Filter Set Current filter setting Use additional search to get reduced list of the searched objects

Database Filters Screenshot Select from this list to navigate to the corresponding filter dialog Or click the tab to get (and manage) all defined filters in the category

Backups All Database Management actions that modify or delete scheduling objects provide an option to save a backup copy of the original definition(s) Backups are stored as text files which can be restored using TWS/WebAdmin or command line composer Backups are saved to the webadmin/backup directory with date/time and username stamp Use the backup manager in the Admin section to administrate stored backup files

Save Backup Example: Modify Calendar Save Backup Copy option

Save Backup Example: Delete Prompt Save Backup Copy option

Backup Administration Select one or more objects Compare two backup records or compare a backup with the current definition of the object in TWS database

Backup Administration Result of comparison of a backup with the current definition of the TWS object

Drafts Drafts are partial or complete Job definitions that are saved as text files Drafts are not saved to the TWS database, but can be recalled later to be reviewed, modified, and saved Drafts are stored with date/time and username stamps Users that do not have ADD permission for jobs in TWS security can be configured to have Save Draft permissions. This is valuable when implementing an approval process for TWS scheduling.

Save Draft Example Click Save Draft

Enter a filename or accept the auto-generated name Save Draft Example Enter a filename or accept the auto-generated name

Saved Drafts Click the Saved Drafts menu item to display all job drafts available. Select a draft from the list, then click Load to open the draft and edit it like a normal job definition.

Advanced Database Management Actions Text Edit: Modify object definitions in command line mode – Useful for making mass changes to multiple definitions Export: Save object definitions to a local or remote file – Useful for backups and migrations Dependent Objects: Show all references to a selected object – Where it is used, what it is a member of, dependencies on it

Text Edit Jobs Example Edit the selected job definitions in the Edit Area, then click Submit to save changes. Select Save Backup Copy to store a backup of the original job definitions.

Dependent Objects Example 1 Select a workstation and then Disiplay/Membership

Dependent Objects Example 1 Domain membership for workstation PC90 Workstation Class membership for workstation PC90

Dependent Objects Example 2 Select one or more jobs Click Display -> Dependent Objects

Dependent Objects Example 2 Jobstream membership for job PC90#TWA_SYNTAX_CHECK Job/Jobstream dependencies on job PC90#TWA_SYNTAX_CHECK

Plan Monitoring and Management Basic Plan Monitoring Plan Management Actions Filters, Searching Submitting Ad-Hoc Jobs and Jobstreams Viewing Previous Production Days Creating Forecasts

Basic Plan Monitoring Plan Monitoring / Management is performed in real time Very fast compared to Job Scheduling Console Workstations Domains Jobstreams Jobs Resources Prompts Files

Click Workstation name to view Jobstreams scheduled on it Plan Workstation List Click Workstation name to view Jobstreams scheduled on it Action Buttons

Plan Domain List

Click Jobstream name to view its Jobs Instances Plan Jobstream List Click Jobstream name to view its Jobs Instances

Click Job name to view Output Plan Job List Click Job name to view Output

Plan Resource List

Plan Prompt List

Plan File List

View Job Output Click on a job in the Plan Job List to display its output (stdlist) Job output is displayed in a new browser window Tail action displays job output in a constantly updating window - useful for “watching” a currently executing job

Job Output

Customize Plan List Layout The Layout action button on each Plan List page will customize the table column layout Select and re-order columns The Fill Entire Page Width option determines whether to stretch the table to fill the entire page Select Reset to Defaults to restore the standard default column layout

Custom Layout Example – Plan Jobstreams Click Settings/Layout to customize

Custom Layout Example – Plan Jobstreams Select which columns to include in the Plan Jobstream List display Use the arrow buttons to re-order the columns Select Save as Default to set the layout as your default

Custom Jobstreams Layout Example – Results

Plan List Sorting, Instant Search Click a column heading to sort by that column. Click again to toggle between ascending and descending order. An arrow symbol shows what sorting is in effect. Instant searching of results

Plan Management Actions All standard TWS plan actions are provided: Cancel, Release, Rerun, Priority, Limit, Fence, etc. Multiple objects can be selected Safe mode is used when canceling multiple jobs or jobstreams Unique Actions: Display Jobstream, Tail Job, Info

Using Filters Click the Filter action button on any Plan List page to display filter options Current filter settings are displayed in the Plan Lists page info header Click Clear Filter on filter page to clear filter settings Filter settings can be saved, restored, and bookmarked

Plan Filter Example

Load Filter Example Right click on the filer name, select “Add to Favourite” to create the bookmark

Set Filter Example

Plan Filters Click the Plan Filters in the navigation frame to go directly to a filter page Set / Load a filter prior to viewing a Plan List Useful if a Plan List contains a very large number of objects

Plan Filters Screenshot Select filter type from this list to set up a new filter Click on tab to manage saved filters of corresponding category

Submitting Jobs and Jobstreams Submit Jobstream Submit Job Submit Task Dependencies and Alias can be specified Submit Jobstream, Submit Job, Submit Task links on Navigation frame Submit Jobstream and Submit Job on Plan Workstation List Submit Job on Plan Jobstream List

Submit Jobstream

Submit Job

Submit Task

Viewing Previous Production Days Set Run History displays a list of logged Symphony files Select the desired run date, then click Set Symphony All Plan Lists will display information from the selected production day Plan List title bars turn green while a previous production day is in use Return to Set Run History and click Use Current to return to the current day

Set Alternate Plan

Previous Production Day Job List Symphony Date Green Title Bar indicating alternate plan

Forecasts The TWS/WebAdmin forecast function generates a complete forecast for a future production day Select Forecast, enter a future date, then click Generate All Plan Lists will display information from the future production day (just like viewing a previous production day)

Generate Forecast

Forecast Job List Forecast Date

TWS/WebAdmin Options Auto-Refresh Display Job Logs: Single / Multiple After Actions GoTo Action Buttons: Top / Bottom, Anchored Date Format, Skin Display filter before listing Window title Disable Job Statistics Etc…

TWS/WebAdmin Options

Auto Refresh Set any auto-refresh rate for Plan Lists Use the browser Reload button to force a manual refresh

Display Job Logs: Single / Multiple Single (default) displays only one stdlist when a job’s output is viewed Multiple displays all stdlists for a job (EVERY and RERUN jobs)

Action Buttons: Top / Bottom, Anchored Bottom : Action buttons are anchored in a separate frame at the bottom of the page so they are always visible Top : Action buttons are anchored in a separate frame at the top of the page so they are always visible

Action Buttons: Top

Date Format MM / DD / YYYY MM – DD – YYYY DD / MM / YYYY

Red skin – useful for indicating privileged user accounts

Job Notes TWS/WebAdmin Job Notes are small text notes that are connected to specific jobs. Primary functions: Contact Information, Recovery Procedures, Comments. Simple HTML can be embedded: formatting, hyperlinks, bullet-lists, etc. Workstation Notes Notes are also accessible from Database Lists

Creating and Managing Job Notes To view Job Notes, select a job from the Plan Job List page or Database Job List page and click Notes From the Job Notes page, users can Add, Modify, and Delete Notes

Display Job Notes Select Job Click Display/Notes

Adding a Job Note Click Add Note

Adding a Job Note Note Type

Modifying Job Notes Click to Edit Click to Delete

Workstation Notes

Reporting TWS/WebAdmin provides a number of reports that can be generated and viewed from a web browser Charts and Graphs Reports can be customized and saved Report output can be stored Reports can be generated and sent to Microsoft Excel in CSV format

Standard TWS/WebAdmin Reports Job History Report Job Details Report TWS Activity Report Production Planning Report TWS Database Report Cross Reference Report Critical Jobs Report

Job History Report Shows historical job execution information Select date range, job / jobstream / workstation names, job status Sort by date, job name, status, etc. Status Pie Chart

Job History Report - Example

Job History Report - Output

Job History Status - Pie Chart

Job Details Report Shows details and statistics for a specified job Presents a view of historical execution time in bar chart or line chart

Job Details Report - Example

Job Details Report - Output

Job Details Report - Bar Chart

TWS Activity Report Shows number of jobs executed per day by week / month / year Bar or line chart views Workstation can optionally be specified Jobs can be grouped by status using accumulated graphs

TWS Activity Report - Examples Select Scale: Day, Week, Month, Year Select Style: Bar, Line, etc.

TWS Activity Report – Month Activity Bar Chart

TWS Activity Report – Week Accumulated Bar Chart

Production Planning Report Generates a pre-production report for a range of future dates Shows jobstreams, descriptions, and estimated run times

Production Planning Report - Example Select Time Range

Production Planning Report - Output

Critical Jobs Report Define one or more lists of Critical jobs, including Deadline Time Critical Jobs Report shows the status of each critical job and whether it completed by the deadline Select which Plan to analyze: Current plan, yesterday's plan, or any previous logged plan

Critical Jobs Report - Example Select Plan to analyze Click to configure Critical Jobs Lists

Manage Critical Jobs List It is possible to define separate lists for each group, application, region, etc. Add a new Critical Job

Critical Jobs Report - Output

Creating Custom Reports TWS/WebAdmin provides access to TWS database Additional data is stored in TWS/WebAdmin database Customized reports from both databases are created with standard SQL queries Basic understanding of SQL syntax and the TWS/WebAdmin table structure is required

Example Custom Report Objective: Create a report that lists all jobs with command that contains the text “conman” SQL Statement: SELECT WKC_NAME, JOD_NAME, JOD_TASK_STRING FROM MDL.JOD_JOB_DEFINITIONS JOD JOIN MDL.WKC_WORKSTATION_CLASSES WKC on JOD.WKC_ID = WKC.WKC_ID WHERE JOD_TASK_STRING LIKE '%conman%'

Example Custom Report Setup View Database Tables Enter SQL Customize Report Title

Example Custom Report Output

Saving Customized Reports Save Report function saves a customized report definition SQL Query, Title, and Report Description are stored Saved Reports are globally available from User Defined Reports menu item

Report Title and SQL Query are filled in automatically Save Report Example Report Title and SQL Query are filled in automatically

User Defined Reports menu item

Storing Reports Storing a report saves the raw report output to a globally available URL Contents of stored reports are static URL can be emailed or posted as a link on an external web page

Store Report Example Store Report

Store Report Results Stored Report URL

Microsoft Excel Integration Send as CSV File, available in several reports, sends report data in CSV (comma separated values) format By default, Excel is associated with the .csv file type and will launch automatically It may be necessary to resize columns in Excel following import

Send as CSV Example Send as CSV

Select Open to pull data into Excel Open CSV Data Stream Select Open to pull data into Excel

View CSV in Excel

Events and Alerting TWS/WebAdmin Event Monitor collects events from TWS Job Abend, Jobstream Stuck, CPU Link Down, etc. Custom events and severities Alerts: Email and custom commands

Event Monitor

Event Configuration

Alerts TWS/WebAdmin alerts generate email notification for events such as Job Abends Wildcards are permitted Multiple email addresses can be entered, separated by commas Enter custom email text in the Email Text field or leave blank to use the default email format Instead of sending email, an alert can execute a custom command

Alert Configuration

Adding an Alert

Miscellaneous Functions Audit Log Viewer TWS Logfile Viewer TWS Mailbox Files TWS Database Files

Audit Log Viewer Displays TWS Database and Plan Audit Logs Auditing must be enabled in the TWS globalopts file Entries can be filtered Send as CSV displays log entries in MS Excel

Database Audit Log

Plan Audit Log

TWS Logfile Viewer TWS maintains the MAESTRO logfile, which contains a running log of TWS operations, including errors and warnings The TWS/WebAdmin Logfile viewer simply displays the MAESTRO logfile and allows filtering and navigation by date Useful for troubleshooting

TWS Logfile Example

TWS Mailbox Files

Other Features Execute TWS/WebAdmin Reports from command line (scheduling reports now possible) Extended TWS Event Type: JOB_LATE Extended filtering possibilities allowing to make complex criteria expresions Instant searching in data results Full control of user permissions, global filters, and saved reports Several maintenance utilities in TWS/WebAdmin Administration

Conclusion Wrap Up Questions Comments Additional Resources: www.horizont-it.com (Europe) www.segus.com (USA) Email: info@segus.com

HORIZONT TWS/WebAdmin Software for Datacenters The Web Interface for TWS Thank you very much for you attention HORIZONT Software for Datacenters Garmischer Str. 8 D- 80339 München Tel ++49(0)89 / 540 162 - 0 www.horizont-it.com 1 1 1 1 1 1 1 1 1 1 1