HORIZONT 1 TWS/WebAdmin HORIZONT Software for Datacenters Garmischer Str. 8 D- 80339 München Tel...

HORIZONT 1 TWS/WebAdmin

HORIZONTSoftware for Datacenters

Garmischer Str. 8 D- 80339 MünchenTel ++49(0)89 / 540 162 - 0www.horizont-it.com

The Web Interface for TWS

TWS/WebAdmin

Web-Based Management and Monitoring of TWS Distributed


Topics• TWS/WebAdmin Features

• Getting Started

• TWS Database Management

• Plan Monitoring and Management

• Job Notes

• Reporting

• Events and Alerts

• Miscellaneous Functions

• Other New Features in Version 2.0


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

The webadmin user has Administrator

privileges

Click link to enter Administration area


Administration Home Page


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 and Jobstream definitions

• Export definitions to files for migration and backups

• View dependent objects and Notes


TWS Database Scheduling Objects

• Workstations

• Workstation Classes

• Domains

• Jobs

• Jobstreams

• Calendars

• Resources

• Prompts

• Parameters

• Users


Workstation Definitions

Click object name to display definition

Action Buttons


Workstation Class Definitions


Domain Definitions


Job Definitions


Jobstream Definitions


Calendar Definitions


Resource Definitions


Prompt Definitions


Parameter Definitions


User Definitions


Common Database Management Actions

• Click on an object name to display its definition (read-only)

• Standard Actions: Add, Modify, Delete

• Display: Show text definitions (multiple objects can be selected)

• Copy: Duplicate an existing object


Example: Display Workstation

Click workstation name to display definition


Example: Display Workstation


Example: Display Workstation (Text)

Select one or more workstations

Click Display


Example: Display Workstation (Text)


Example: Add Calendar


Example: Add Calendar

Click dates to toggle

Navigation:< Month ><< Year >>


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)

Backup copy of original job definition is saved

by default


Example: Delete Jobstream

Select one or more jobstreams

Click 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

• 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

Use either * or @ as the wildcard character…

Both work!


Database Filter Set

Current filter setting


Database Filters Screenshot


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


Save Backup Example: Modify Job

Save Backup Copy option


Save Backup Example: Delete Prompt

Save Backup Copy option


Backup Options

Set default Backup options


Drafts

• Drafts are partial or complete Job and Jobstream definitions that are saved as text files

• Drafts are not saved to the TWS Mozart 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 and jobstreams 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


Save Draft Example

Enter a filename or accept the auto-generated name


Saved Drafts

Click the Saved Drafts button on the Database Job List page to display all job drafts. 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

Domain membership for workstation VOGON

Workstation Class membership for workstation VOGON


Dependent Objects Example 2

Jobstream membership for job FTPJOB

Dependencies on job FTPJOB


Plan Monitoring and Management

• Basic Plan Monitoring

• Plan Management Actions

• Using Filters

• Submitting Ad-Hoc Jobs and Jobstreams

• Viewing Previous Production Days

• Forecasting

• TWS/WebAdmin Options


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


Plan Workstation List

Click Workstation to view Jobstreams

Action Buttons


Plan Domain List


Plan Jobstream List

Click Jobstream to view Jobs


Plan Job List

Click Job 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 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 SortingClick 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.


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 top left corner of Plan Lists

• Click Clear Filter on filter page to clear filter settings

• Filter settings can be saved, restored, and bookmarked


Plan Filter Example


Load Filter Example

Click to add browser 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


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 Run History


Previous Production Day Job List

Green Title BarSymphony Date


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

• Compression

• Disable Job Statistics


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 (default): Action buttons are displayed at the bottom of the page

• Bottom (Anchored): Action buttons are anchored in a separate frame at the bottom of the page so they are always visible

• Top (Anchored): Action buttons are anchored in a separate frame at the top of the page so they are always visible


Action Buttons: Bottom (Anchored)


Date Format

• MM / DD / YYYY

• MM – DD – YYYY

• DD / MM / YYYY

• DD – MM – YYYY

• YYYY / MM / DD

• YYYY – MM – DD


Skin

3D Skin


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 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

• Some 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 Date 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 List


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 extracts and stores TWS object definitions and job history data in a relational database (RDBMS)

• Customized reports are created with standard SQL

• Basic understanding of SQL syntax and the TWS/WebAdmin table structure is required


Example Custom Report

• Objective: Create a report that lists all jobs created by user “maestro” with a description that contains the text “extract”

• SQL Statement:

SELECT * FROM jobs WHERE creator='maestro' AND description LIKE '%extract%'


Example Custom Report Setup

Enter SQL

Set Title

View Database Tables


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


Save Report Example

Report Title and SQL Query are

filled in automatically


User Defined Reports

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


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


TWS Database Files


Other New Features in Version 2.0• Execute TWS/WebAdmin Reports from command

line (scheduling reports now possible)• New options for extracts, improved performance for

extracts, new Current-Plan extracts• New NOP action for Plan jobs and jobstreams, New

Rerun: Step action for jobs• Improved page refreshing, new R refresh hotkey• Pop-up selectors filter on partially entered names• Enhanced control of user permissions, global filters,

and saved reports• Improved maintenance utilities in TWS/WebAdmin

Administration


Upcoming Features

• Composer Versioning, Migration Tool

• Enhanced SAP Extended Agent Job Configuration

• TWS Database Validation (Health Check)

• Critical Path Monitoring

• TWS/Graph Integration

• Additional Language support


Conclusion

• Wrap Up

• Questions

• Comments

• Additional Resources:

www.horizont-it.com (Europe)www.segus.com (USA)Email: [email protected]


The Web Interface for TWS

HORIZONTSoftware for Datacenters

Garmischer Str. 8 D- 80339 MünchenTel ++49(0)89 / 540 162 - 0www.horizont-it.com

TWS/WebAdmin

Thank you very much for you attention

Date post:	12-Jan-2016
Category:	Documents
Upload:	allison-snow
View:	226 times
Download:	2 times

HORIZONT 1 TWS/WebAdmin HORIZONT Software for Datacenters Garmischer Str. 8 D- 80339 München Tel...

Documents