tibco mainframe webui user's guide...— z/os jobs completion data — alerts and events from...

TIBCO® Mainframe WebUI User's GuideSoftware Release 2.0November 2014

Two-Second Advantage®

Important Information

SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCHEMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY(OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THEEMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANYOTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.

USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS ANDCONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTEDSOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THECLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOADOR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE)OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USERLICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THESOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, ANDYOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BEBOUND BY THE SAME.

This document contains confidential information that is subject to U.S. and international copyright lawsand treaties. No part of this document may be reproduced in any form without the writtenauthorization of TIBCO Software Inc.

TIBCO, Two-Second Advantage, TIBCO Enterprise Message Service, TIBCO Hawk, TIBCO MainframeService Tracker, TIBCO Object Service Broker, TIBCO Rendezvous, and TIBCO Substation ES are eitherregistered trademarks or trademarks of TIBCO Software Inc. in the United States and/or othercountries.

Enterprise Java Beans (EJB), Java Platform Enterprise Edition (Java EE), Java 2 Platform EnterpriseEdition (J2EE), and all Java-based trademarks and logos are trademarks or registered trademarks ofOracle Corporation in the U.S. and other countries.

All other product and company names and marks mentioned in this document are the property of theirrespective owners and are mentioned for identification purposes only.

THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOTALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASEDAT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWAREVERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM.

THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICALERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESECHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCOSOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S)AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME.

THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY ORINDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE,INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.

Copyright © 2011-2014 TIBCO Software Inc. ALL RIGHTS RESERVED.

TIBCO Software Inc. Confidential Information

2

TIBCO® Mainframe WebUI User's Guide

Contents

TIBCO Documentation and Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Starting Mainframe WebUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Starting Mainframe WebUI Locally . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Starting Mainframe WebUI Remotely . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8

Signing in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Manage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10

Manage – Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Manage – Connectivity Details: EMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Manage – Connectivity Details: RV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Manage – Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Manage – Connect: EMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Manage – Connect: RV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Manage – Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Manage - Real Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

Manage - Real Time: EMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Manage - Real Time: RV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Manage - Real Time: CICS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

Manage - Real Time: IMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Track . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Track – Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Track – Connectivity Details: RV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Track – Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Track – Connect: RV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Track – Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Track – Events: Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23

Track – Events: Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24

Track – Events: SYSLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Track – Events: Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Access - Entities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Access - Entities: Entity Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

Access - My Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Access - For Master User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

For Master User - User Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

User Management - User Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

For Master User - Global Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

3


TIBCO Documentation and Support Services

All TIBCO documentation is available on the TIBCO Documentation site, which can be found here:

https://docs.tibco.com

Product-Specific Documentation

Documentation for TIBCO products is not bundled with the software. Instead, it is available on theTIBCO Documentation site. To directly access documentation for this product, double-click thefollowing file:

TIBCO_HOME/release_notes/TIB_mainframewebui_version_docinfo.html

The following documents for this product can be found on the TIBCO Documentation site:

● TIBCO Mainframe WebUI Installation● TIBCO Mainframe WebUI User’s Guide● TIBCO Mainframe WebUI Release Notes

How to Contact TIBCO Support

For comments or problems with this manual or the software it addresses, contact TIBCO Support asfollows:

● For an overview of TIBCO Support, and information about getting started with TIBCO Support,visit this site:

http://www.tibco.com/services/support

● If you already have a valid maintenance or support contract, visit this site:

https://support.tibco.com

Entry to this site requires a user name and password. If you do not have a user name, you canrequest one.

How to Join TIBCOmmunity

TIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is aplace to share and access the collective experience of the TIBCO community. TIBCOmmunity offersforums, blogs, and access to a variety of resources. To register, go to:

http://www.tibcommunity.com

4


https://docs.tibco.com

http://www.tibco.com/services/support

https://support.tibco.com

http://www.tibcommunity.com

Product Overview

TIBCO Mainframe WebUI is an out-of-the-box lightweight, agile, and user-friendly component thatadds value and insight to your mainframe and TIBCO mainframe integrations.

The product’s capabilities include viewing of information, management, administration, configuration,and deployment of z/OS mainframe integration products.

Currently, TIBCO Mainframe WebUI supports the following functions:

● Operationally interacting with the Substation ES Administration interface● Viewing information published by TIBCO Mainframe Service Tracker by the following categories:

— z/OS Jobs completion data— Alerts and events from the TIBCO products and user-enabled applications— Subscription information of z/OS SYSLOG

● Viewing of information, management, administration, configuration, and deployment of z/OSmainframe integration products from iPad device.

● Supporting workspaces to store different configurations.

ArchitectureThe following figure shows a complete enterprise view of the possible deployments in which you canuse TIBCO Mainframe WebUI.

Enterprises use Mainframe WebUI from multiple workstations. Planning the related deployment andimplementation requires some consideration. For example, you can install Mainframe WebUI and its

5


associated services on a server, then run the lightweight and agile UI component on multiple browsersand across multiple workstations.

6


Starting Mainframe WebUI

After installing TIBCO Mainframe WebUI, you have several ways to start it.

● Starting Mainframe WebUI Locally● Starting Mainframe WebUI Remotely

Result

After starting Mainframe WebUI successfully, the initial startup page is displayed.

Starting Mainframe WebUI LocallyIf you do not run a remote Tomcat server, you can start Mainframe WebUI locally.

Procedure

1. From the Start menu in Windows, select All Programs > TIBCO > TIBCO Mainframe WebUI 2.0 >Start Tomcat.A terminal window is displayed along with an output that shows that the Tomcat server is running.

2. From the Start menu, select All Programs > TIBCO > TIBCO Mainframe WebUI 2.0 > StartBrowser. Or you can open a Web browser and go to http://localhost:port number/MF_WebUI.port number is the one you specified when you installed the product.

See the readme file for more details regarding supported web browsers and versions.

7


Starting Mainframe WebUI RemotelyIf you run a remote Tomcat server, you need to start Mainframe WebUI remotely.

Procedure

● Open a Web browser and go to http://host:port number/MF_WebUI.host is the name or IP address of the machine on which the Tomcat server is running. port number isthe one you specified when you installed the product.

8


Signing in

The sign-in users have extra access to Configure page , Deploy page , Define page and Access page.

Procedure

1. On the Mainframe WebUI startup page, click SIGN IN, which is in the upper-right corner of thepage.

2. Provide a user name in the Username field and a password in the Password field.

3. Click Sign In.

If you do not have a user name or password, click Contact master to request one. You canuse the master account to sign in by default. The user name is master and the password ismaster.

4. Select a workspace from the list next to the ABOUT button.The default workspaces in Mainframe WebUI are CICS_EMS and CICS_RV.

Result

After signing-in, the following page is displayed.

9


Manage

You can use the Manage page to manage connections to TIBCO Substation ES through TIBCOMainframe WebUI.

● You can use the Manage – Connectivity page to add a new connectivity, or delete, update and storethe existing connectivity information.

● You can use the Manage – Connect page to establish connections to TIBCO Substation ES.● You can use the Manage – Console page to run the Substation ES operational commands.● You can use the Manage - Real Time page to see the monitor views of the available connections.

Manage – ConnectivityYou can use this page to add a new connectivity, or delete, update and store the existing connectivityinformation.

This page is only available after signing in.

Field/Button Description

Add Click this button to add a certain type of connection.

Delete Click this button to delete a selected connection.

Connect Click this button to connect to a selected connection.

If the connection is successful, the connection is applied.

Audit Click this button to show more information about a connection.

Search After you type the key words of a connection in this field, all the connectionnames that contain the key words are filtered and displayed.

Name The connection name you specified when you stored a connection.

Endpoint The endpoint name you have defined for an EMS or RV connection.

URL The URL information of the connection that you have stored.

The following fields appear only after you click Audit.

Modified On Last time the connection was modified.

Modified By The user who modified the connection.

Created On Time when the connection was first created.

Created By The user who created the connection.

10


Manage - Connectivity Details: EMSFrom the Manage – Connectivity page, click EMS and double-click an existing connectivity; the EMSConnectivity Details page is displayed. If you click Add, the New EMS Connectivity Details pageappears.


Connection Name The name you specify for an EMS connection.

Endpoint NameType an endpoint name for an EMS connection, or click to selectone.

This field can be changed to Customized User Selectionfiled, if you change the parameters in the other fields.

Host (URL) The syntax is host: port, where:

host is the URL or IP address of the machine on which the EMS serverruns.

port is the TCP port number.

These values match the ones to which the Substation ESAdministration interface is connected.

Default: TIBCO.EMS.Server:7222

CHECK Click this button to check whether the host URL you have provided iscorrect. If the host URL is correct, Checked successfully isdisplayed. Otherwise an error message is displayed.

User Name The user identifier if a special identification applies to the connection.

Default: admin

Password The password associated with the username if a special identificationapplies to the connection.

Destination Type The type of the destination to which the Substation ES Administrationinterface listens. The options are Queue (default) or Topic.

Queue or Topic Name The name of a queue or a topic to which Mainframe WebUI sends thecommand request. This name is the same as the one used by theSubstation ES Administration interface.

Default: tibss.admin.sxs.request

Substations Select a Substation ID from the list.

If no Substation ID is listed, click to refresh, and get theSubstation IDs from Substation ES.

Save Click this button to save a connection.

Cancel Click this button to go back to the previous page.

11



Replicate Click this button to make a copy of a connection.

Connect Click this button to make a connection to the Substation ES server. Ifthe connection is successful, the connection is applied.

Reset Click this button to cancel the changes you just made.

Manage - Connectivity Details: RVFrom the Manage – Connectivity page, click RV and double-click an existing connection; the RVConnectivity Details page is displayed. If you click Add, the New RV Connectivity Details page isdisplayed.


Connection Name The name you specify for an RV connection.

Endpoint NameType an endpoint name for an RV connection, or click to selectone.


Daemon (URL) The syntax is host: port, where:

host is the URL or IP address of the machine on which theRendezvous daemon runs.



Default: RV.daemon.url:7500

CHECK Click this button to check whether the RV Daemon URL you haveprovided is correct. If the URL is correct, Checked successfully isdisplayed. Otherwise an error message is displayed.

Network The IP address of your network, if applicable.

Service The UDP service port for the Substation ES Administrationinterface.

Default: 7555

Subject Name The Rendezvous subject name to which Substation ES listens, andalso to which Mainframe WebUI sends the Substation ESoperational commands.


12



Substations Select a Substation ID from the list.

If no Substation ID is listed, click to refresh, and get theSubstation IDs from Substation ES.

Save Click this button to save a connection.


Replicate Click this button to make a copy of a connection.

Connect Click this button to apply a connection to the Substation ES server.If the connection is successful, the connection is applied.


Manage – ConnectYou can define EMS or RV as the connection type for the Substation ES Administration interface.

Manage – Connect: EMSYou can use this page to establish connections to TIBCO Substation ES using EMS as the connectiontype. This is the default page after starting Mainframe WebUI.


Endpoint NameType an endpoint name for an EMS connection, or click to selectone.


Host (URL) The syntax is host: port, where:

host is the URL or IP address of the machine on which the EMSserver runs.



Default: TIBCO.EMS.Server:7222

CHECK Click this button to check whether the host URL you have providedis correct. If the host URL is correct, Checked successfully isdisplayed. Otherwise an error message is displayed.

User Name The user identifier if a special identification applies to theconnection.

Default: admin

13



Password The password associated with the username if a specialidentification applies to the connection.

Destination Type The type of the destination to which the Substation ESAdministration Interface listens. The options are Queue (default) orTopic.

Queue or Topic Name The name of a queue or a topic to which Mainframe WebUI sendsthe command request. This name is the same as the one used by theSubstation ES Administration interface.


Connect Click this button to verify whether the EMS server connection setupis correct.

If the connection is successful, Connected successfully isdisplayed, and the connection is applied.

If an error occurs, Failed to connect to the server at host isdisplayed.

The field where the error occurs will be highlighted, and theinstruction message will be displayed below the field.

Reset Click this button to reset the changes and return to the previouspage.

Manage – Connect: RVYou can use this page to establish connections to TIBCO Substation ES using RV as the connection type.


Endpoint NameType an endpoint name for an RV connection, or click to selectone.



host is the URL or IP address of the machine on which theRendezvous daemon runs.




CHECK Click this button to check whether the RV Daemon URL you haveprovided is correct. If the URL is correct, Checked successfully isdisplayed. Otherwise an error message is displayed.

14




Service The UDP service port for the Substation ES Administrationinterface.

Default: 7555

Subject Name The Rendezvous subject name to which Substation ES listens, andalso to which Mainframe WebUI sends the Substation ESoperational commands.


Connect Click this button to verify whether the RV daemon connection setupis correct.

If the connection is successful, Connected successfully isdisplayed, and the connection is applied.

If an error occurs, Invalid argument is displayed.

The field where the error occurs will be highlighted, and theinstruction message will be displayed below the field.

Reset Click this button to reset the changes and return to the previouspage.

Manage – ConsoleYou can use the Manage – Console page to run the Substation ES operational commands.

This page is only accessible after you have established a connection to Substation ES. Otherwise awarning page with the message A connection is required before using the function isdisplayed.

15



Command Type a Substation ES operational command that you want Substation ES toexecute. Or you can select a command from the list after clicking .

The default value is HELP.

Output -Substation ID

All the Substation ids under the applied connection are listed in this field.

Click to refresh the Substation ids under the applied connection.

You must get SSID firstly, otherwise you can not execute anycommands

Enable Click this button to execute either of these commands for the recipe or triggeryou to select in the lower right pane:

ENABLE, RECIPE|RID=name, [INTF=intf-id]

ENABLE, TRIGGER|TID=name, [INTF=intf-id]

Disable Click this button to execute either of these commands for the recipe or triggeryou to select in the lower right pane:

DISABLE, RECIPE|RID=name, [INTF=intf-id]

DISABLE, TRIGGER|TID=name, [INTF=intf-id]

Suspend Click this button to execute either of these commands instructing the ESBinterface to stop processing for an individual recipe, or all recipes related to aparticular BES:

SUSPEND, RECIPE|RID=name,[INTF|IID=intf-id]

SUSPEND, *,FOR=BES-Name IID,[INTF|IID=intf-id]

Refresh Click this button to load a new copy of the recipe or trigger you to select in thelower right pane:

REFRESH, RECIPE|RID=name, [INTF=intf-id]

REFRESH, TRIGGER|TID=name, [INTF=intf-id]

all ESB Select this check box to execute the ENABLE, DISABLE, SUSPEND, or REFRESHcommand, as applicable, for all the ESB interfaces that pertain to the recipe ortrigger you to select in the lower right pane.

Manage - Real TimeYou can use the Real Time page to see the default monitor views of the available connections.


After you have established a connection to Substation ES, a Substation ID list is displayed on this page.

All the Substation IDs are listed in the list. If no Substation ID is listed, click to refresh, and get theSubstation IDs from Substation ES.

16


After you select an ID from the Substation ID list or refresh the list, four charts are displayed on thispage. The charts provide information regarding the number of available connections for EMS, RV,CICS, and IMS. The four charts also show the statuses of connections. The charts for EMS and RV showConnected, NotStarted, and Disconnected. The charts for CICS and IMS show Connected andDisconnected.

The following picture shows the four charts.

Click the different part of a chart, you are brought to the different page which is related to the chart.

Manage - Real Time: EMSYou can use this page to see the monitor views of the available EMS connections .


Field Description

Substation ID All the Substation IDs are listed in this field. If no Substation ID is listed,

click to refresh, and get the Substation IDs from Substation ES.


Connection Name The name you specify for an EMS connection.

Status The connection status of EMS including Connected, Notstarted, andDisconnected.

Endpoint The URL of an endpoint for an EMS connection.

If you click different parts of the bar or the status buttons ( Connected, Notstarted, and Disconnected )at the bottom of the page, the related connections are filtered and displayed accordingly.

17


From the Manage - Real Time: EMS page, double-click an existing connection, the EMS ConnectionDetails page is displayed. The content of this page is match with the EMS connection in the Definemodule.

Manage - Real Time: RVYou can use this page to see the default monitor views of the available RV connections.


Field Description

Substation IDAll the Substation IDs are listed in this field. If no Substation ID is listed, click to refresh, and get the Substation IDs from Substation ES.

Search After you type the key words of a connection in this field, all the connection namesthat contain the key words are filtered and displayed.

ConnectionName

The name you specify for an RV connection.

Status The connection status of RV including Connected, Notstarted, and Disconnected.

Endpoint The URL of an endpoint for an RV connection.

If you click different parts of the bar or the status buttons ( Connected, Notstarted, and Disconnected )at the bottom of the page, the related connections are filtered and displayed accordingly.

From the Manage - Real Time: RV page, double-click an existing connection, the RV ConnectionDetails page is displayed. The content of this page is match with the RV connection in the Definemodule.

Manage - Real Time: CICSYou can use this page to see the default monitor views of the available CICS interfaces.


Field Description

SubstationID All the Substation IDs are listed in this field. If no Substation ID is listed, click to

refresh, and get the Substation IDs from Substation ES.


Interface The name you specify for a CICS interface.

Status The connection status of CICS including Connected and Disconnected.

Endpoint The endpoint name you have defined for a CICS interface.

18


If you click different parts of the bar or the status buttons ( Connected and Disconnected ) at thebottom of the page, the related connections are filtered and displayed accordingly.

From the Manage - Real Time: CICS page, double-click an existing interface, the CICS InterfaceDetails page is displayed. The content of this page is match with the CICS interface in the Definemodule.

Manage - Real Time: IMSYou can use this page to see the default monitor views of the available IMS interfaces.


Field Description

Substation IDAll the Substation IDs are listed in this field. If no Substation ID is listed, click to refresh, and get the Substation IDs from Substation ES.


Interface The name you specify for an IMS interface.

Status The connection status of IMS including Connected and Disconnected.

Endpoint The endpoint name you have defined for an IMS interface.

If you click different parts of the bar or the status buttons ( Connected and Disconnected ) at thebottom of the page, the related connections are filtered and displayed accordingly.

From the Manage - Real Time: IMS page, double-click an existing interface, the IMS Interface Detailspage is displayed. The content of this page is match with the IMS interface in the Define module.

19


Track

You can use the Track page to establish a connection to Substation ES and track z/OS events.

You can use the Track – Connectivity page to add a new connectivity, or delete, update and store theexisting connectivity information.

You can use the Track – Connect page to create a connection to Substation ES.

You can use the Track – Events page to track z/OS events.

Track – ConnectivityYou can use this page to add a new connectivity, or delete, update and store the existing connectivityinformation to track z/OS events.

This page is only available after signing in.


Add Click this button to add a certain type of connection.

Delete Click this button to delete a selected connection.

Connect Click this button to connect to a selected connection.

If the connection is successful, the connection is applied.

Audit Click this button to show more information about a connection.


Name The connection name you specified when you stored a connection.

URL The URL information of the connection that you have stored.

Endpoint The endpoint name you have defined for an RV connection.



Modified By The user who modified the connection.


Created By The user who created the connection.

20


Track – Connectivity Details: RVFrom the Track – Connectivity page, click RV and double-click an existing connection, the RVConnectivity Details page is displayed. If you click Add, the New RV Connectivity Details page isdisplayed.


Connectivity Name The name you specify for an RV connectivity.

Endpoint NameType an endpoint name for an RV connectivity, or click to select one.

This field can be changed to Customized User Selection filed,if you change the parameters in the other fields.


host is the URL or IP address of the machine on which the Rendezvousdaemon runs.


These values match the ones to which the Substation ES Administrationinterface is connected.


CHECK Click this button to check whether the RV Daemon URL you haveprovided is corrected. If the URL is correct, Checked successfully isdisplayed. Otherwise an error message is displayed.


Service The UDP service port for the Substation ES Administration interface.

Default: 7555

Rendezvous Subject Names

Jobstep The Rendezvous subject name with which the Tracker Server publishesthe message on the related job.

Default: tibtrk.jobstep

Resend The Rendezvous subject name to which the Tracker Server listens forRESEND requests.

Default: tibtrk.resend.request

Alert The Rendezvous subject name to which the Tracker Server sends all alertmessages.

Default: tibtrk.usermsg

SYSLOG The Rendezvous subject name to which the Tracker Server publishes allSYSLOG messages of interest.

Default: tibtrk.logmsg

21



Save Click this button to save a connectivity.


Replicate Click this button to make a copy of a connectivity.

Connect Click this button to apply a connectivity to the Substation ES server. Ifthe connectivity is successful, the connection is applied.


Track – ConnectYou can define RV as the connection type for the Substation ES Administration interface.

Track – Connect: RVYou can use this page to establish connections to TIBCO Substation ES using RV as the connection type.


Endpoint NameType an endpoint name for an RV connection, or click to select one.

This field can be changed to Customized User Selection filed,if you change the parameters in the other fields.


host is the URL or IP address of the machine on which the Rendezvousdaemon runs.


These values match the ones to which the Substation ES Administrationinterface is connected.


CHECK Click this button to check whether the RV Daemon URL you haveprovided is corrected. If the URL is correct, Checked successfully isdisplayed. Otherwise an error message is displayed.


Service The UDP service port for the Substation ES Administration interface.

Default: 7555

Rendezvous Subject Names

Jobstep The Rendezvous subject name with which the Tracker Server publishesthe message on the related job.

Default: tibtrk.jobstep

22



Resend The Rendezvous subject name to which the Tracker Server listens forRESEND requests.

Default: tibtrk.resend.request

Alert The Rendezvous subject name to which the Tracker Server sends all alertmessages.

Default: tibtrk.usermsg

SYSLOG The Rendezvous subject name to which the Tracker Server publishes allSYSLOG messages of interest.

Default: tibtrk.logmsg

Connect Click this button to verify whether the RV daemon connection setup iscorrect.

If the connection is successful, Connected successfully is displayed,and the connection is applied.

If an error occurs, Invalid argument is displayed.

The field where the error occurs will be highlighted, and the instructionmessage will be displayed below the field.

Reset Click this button to reset the changes and return to the previous page.

Track – EventsYou can use the Track – Events page to track z/OS events under the applied connection.

You can track z/OS events by the following categories:

● Jobs

See Track – Events: Jobs.● Alerts

See Track – Events: Alerts.● SYSLOG

See Track – Events: SYSLOG.

You can configure the settings applied to track z/OS events. See Track – Events: Configuration.

Track – Events: JobsThe Tracker server publishes Rendezvous messages to the tibtrk.jobstep subject at the end of eachjob step and at the end of the job that the Tracker server is monitoring.


23



Start Click this button to start tracking jobs.

Pause Click this button to stop tracking jobs for a short time.

Stop Click this button to stop tracking jobs.

Track ID A combination of the MVS system and subsystem identifiers of the Tracker server,which publishes the message.

Job Name The MVS JES job name that is of interest to the Tracker server.

Job ID The MVS JES job identifier that is of interest to the Tracker server.

Step Name The step name of the job that is of interest to the Tracker server. If this field isblank, this message is a job-end message.

Step # The counter of a job-step message. If the value is 0, the message is a job-endmessage.

Status The step or job-end status, for example, Normal End, rc=0.

Type The type of data for this message. The value is either Job end (job-end data) orStep end (step-end data).

CPU The number of CPUs used in 100th of seconds.

EXCP The number of EXCPs issued by the step or job.

Start Time The start time, which is displayed on the job message only.

End Time The end time, which is displayed on all the messages.

ASID Address Space Identifier of the MVS jobs.

Message # The sequence number of the message from the Tracker server.

Track – Events: AlertsThe Tracker server publishes alert messages on the default tibtrk.usermsg subject. Alert messages areavailable for the Rendezvous connection type only.



Start Click this button to start tracking alerts.

Pause Click this button to stop tracking alerts for a short time.

Stop Click this button to stop tracking alerts.

24



Track ID A combination of the MVS system and subsystem identifiers of the Tracker server,which publishes the message.

Message ID The identifier of the message.

Severity The severity code of the message. Different codes correspond to different icons.

● The icon corresponds to 0 or I (informational) .

● The icon corresponds to 1 or W (warning).

● The icon corresponds to 2 or E (error).

● The icon corresponds to S (severe error), C (critical error) or F (fatal error).

Type The message type:

● Alert means that the message is an alert from a Tracker Server subsystem.

● Notify means that the message is a notification from a Tracker Serversubsystem.

Text The content of the message.

Number The sequential number of the message.

SupportAction

The action-required items, if any.

Issue Source The related program or source of the issue in question.

Issue SourceSub

The related subprogram or subsource of the issue in question.

IssueCorrelation

Additional information, if any.

Host Name The name of the machine on which the job runs.

Host Platform The related platform, such as BATCH or CICS, of the issue in question.

Track – Events: SYSLOGTIBCO Mainframe Service Tracker publishes SYSLOG messages on the default tibtrk.logmsg subject.The SYSLOG messages are available for the Rendezvous connection type only.


25



Start Click this button to start tracking SYSLOG.

Pause Click this button to stop tracking SYSLOG for a short time.

Stop Click this button to stop tracking SYSLOG.

Track ID A combination of the MVS system and subsystem identifiers of the Trackerserver, which publishes the message.

Job ID The MVS JES job identifier that is of interest to the Tracker server.

Message Text The message content.

Track – Events: ConfigurationYou can use this page to configure the settings applied to track z/OS events.


Refresh Rate (1-60) The number of seconds between each update for Jobs, Alerts, and SYSLOG.

Default: 10

Number of Rows toDisplay (10-100)

The maximum number of lines to be displayed on one page for Jobs, Alerts,and SYSLOG.

Default: 10

Maximum EntriesShown in List(100-5000)

The maximum number of lines that Mainframe WebUI stores for pagination.

Default: 200

Latest Table Entry The options are:

● At the top: The latest entry is displayed at the top of the table.● At the bottom: The latest entry is displayed at the bottom of the table.

Save Click this button to save the changes you have made.


26


Access

You can use the Access page to manage your accounts and assign different access permissions todifferent accounts.

● You can use the Access - Entities page to view all the available entities in the Configure module andDefine module.

● You can use the Access - My Account page to configure your account.● You can use the Access - For Master User page to manage all the accounts in Mainframe WebUI and

set the usage of Mainframe WebUI.

Access - EntitiesYou can use this page to view all the available entities in the Configure module and Define module.You can also manage the entity permission when you sign in the product as a master user.

List/Field Description

Define-Configure

Select a type of entities from the list.

Name Entity name you specified in the Configure module or Define module.

Type Type of an entity.

Owner If you are the owner of an entity, you are allowed to modify it.

Viewer If you are the viewer of an entity, you are not allowed to modify it.

Search After you type the key words of an entity in this field, all the entity names thatcontain the key words are filtered and displayed.

Access - Entities: Entity DetailsFrom the Access - Entities page, double-click an existing entity, the Entity Details page is displayed.

Field/CheckBox Description

Name Account name you specified.

Owner Select this check box to allow a specific user to modify the entity.

This check box is only available when you are the owner of this entity.

Viewer If this check box is selected, the corresponding user is not allowed to modify theentity.

This check box is only available when you are the owner of this entity.


Cancel Click this button to cancel the changes you have made.

27


Field/CheckBox Description


Access - My AccountYou can use this page to configure your account.


User Name This field shows the user name. This field is not editable.

New Password Type new password in this field.

Confirm New Password Type the same password that you typed in the New Password field.

Last Name Provide your last name in this field.

First Name Provide your first name in this field.

Number of Rows to Display(10-100)

Numbers of lines to be displayed on one page.

Default: 10



Access - For Master UserThe Access - For Master User page is used for the master user.

You can manage all the accounts in Mainframe WebUI. See For Master User - User Management.

You can set the usage of Mainframe WebUI. See For Master User - Global Settings.

For Master User - User ManagementYou can use the For Master User - User Management page to manage all the accounts in MainframeWebUI.

This page is only available for the master user.


Add Click this button to add a new account.

Delete Click this button to delete a selected account.

Audit Click this button to show more information about an account.

Refresh Click this button to refresh the accounts in Mainframe WebUI.

28



Search After you type the key words of an account in this field, all the accountnames that contain the key words are filtered and displayed.

Name Account name you specified.

User Name User name you specified.



Modified By The user who modified the account.


Created By The user who created the account.

User Management - User Details

From the For Master User - User Management page, double-click the existing account or click Add, theUser Details page is displayed.

Field/Button/Check Box Description

Last Name Type a last name for an account name.

First Name Type a first name for an account name.

User Name This field shows the user name.

New Password Type a new password for an account.

Workspace You can select a workspace from the list. The default workspaces areCICS_EMS and CICS_RV.

Access denied Select this check box to deny a specific user access to a workspace.

Access Permission Select this check box to permit a specific user access to a workplace.

Entity Permission You can select a type of entities from the list. The entities that belongin this type are filtered and displayed.


Cancel Click this button to cancel the changes you have made.

Replicate Click this button to replicate an account.

Reset Click this button to cancel the changes you have made.

When you select a type from the Entity Permission list, the following fields appear:

29


Field/Button/Check Box Description

Entity Name Name of an entity you specified.

Type It shows the type of an entity.

Owner If you are the owner of an entity, you are allowed to modify theentity.

Viewer If you are the viewer of an entity, you are not allowed to modify theentity.

For Master User - Global SettingsYou can use the For Master User - Global Settings page to set the usage of Mainframe WebUI.

Area/Field/Button Description

Usage To set the usage of the product you can select or clear the following check boxes:

● Track● Manage● EMS● RV● CICS● IMS● Batch● RED

RV InstallationPath

Provide the RV installation path in this field. For example: TIBCO_HOME/tibrv/version

This field is only available when the RV check box is selected. Afteryou provide the path in the field, you should restart the Tomcat server.



30


tibco mainframe webui user's guide...— z/os jobs completion data — alerts and events from...

Documents