Start of changeView sets, views and mapsEnd of change

A view set is a number of related views that are used together to manage the same managed object.

Start of changeA view is a display format that is used to interact in a particular way with the specified managed object. A view exists within a view set. Views can display information about CICS® resources or CICSPlex® SM definitions.End of change

The different types of views are:

Views consist of a number of possible components:

Start of changeA map is a special type of view that displays the relationship between a group of associated resource definitions. See Mapping CICSPlex SM definitions for more information.End of change

Title

This is displayed at the top of the page and is the descriptive title of the view. This title is similar but not always identical to the link on the associated menu. The title area includes the link to the customizable help if available, print preview icon, and a resource icon.

This area is always present.

Start of change

View name and resource name

This information is displayed at the bottom of a view below the work frame. It is always present.

The resource name is the name of the resource object associated with the view. Each resource object is represented by a resource table. These resource tables are described in the CICSPlex System Manager Resource Tables Reference.

All WUI views supplied with CICSPlex SM by IBM® are named EYUSTARTobject.viewtype where object is the name of the associated resource object and viewtype describes the type of view. For example, the view named EYUSTARTTASK.TABULAR is a tabular view listing active tasks. It is derived from a resource table named TASK. EYUSTARTCSYSDEF.CREATE is a definitional view used to create a new CICS system definition. It is derived from a resource table called CSYSDEF.

Throughout this document views are referred to by menu names rather than file or resource names.

End of change

Message area

This area displays messages and contains a help icon to the right of the area that links you to the explanation of the message being displayed.

This area appears automatically when required.

Selection criteria and refresh area

This area allows you to set the context and scope and refresh the view currently displayed. You can refresh views in two ways:

For information about setting the selection criteria, see Selection criteria.

This area appears automatically, as applicable, but the contents may be customized using the View Editor. For information about the View Editor, see Customizing the Web User Interface.

Refresh on demand

You can refresh the view displayed at any time by selecting the Refresh button in the selection criteria and refresh area, when available.

Automatic Refresh

The automatic refresh function is available only if you are using a Javascript-enabled browser. The automatic refresh function allows you to control how frequently the data in a view is updated. For information about automatic refresh, see Refreshing views.

Form

This is the information that is displayed in the work frame. A form is always present if there is data.

The contents of the form depends on the type of view being displayed:

Tabular
A display that shows selected attributes from multiple instances of the resource type, or summarized records. The view may consist of a number of pages. You can jump to any of the available pages by entering the required page number or use Next and Previous buttons to step through the available pages one at a time.

Start of changeEach attribute in a tabular view is displayed in a separate column. The

select all

(select all) and

deselect all

(deselect all) icons at the top of the Record column allow you to select one or more records for an action. You can use these icons to select or deselect all of the records that matched your selection criteria. You can also combine the select all icon and the check boxes in the Record column to select all, then deselect a few.End of change

On a summarized display, which is a special form of the tabular view, the number in the Record count column indicates the number of records combined into the single line of summary information. The total number of records and the number of display pages in the summary is indicated above and below the summary table. You can perform actions on all the items in a summary line by selecting the check box in the left-hand column.

The up and down arrow icons (see Table 2) in a column title box indicate that the contents of the columns can be sorted in either ascending or descending order. For information about sorting a tabular view, see Sorting a view.

The summarize icon (see Table 2) in a column title box indicates that the column can be used to summarize the data in the view.

The fields to be used for sorting and summarizing a tabular view are defined when the view is created using the Web User Interface View Editor. See Summarizing a view for details.

Some attribute values may appear as links to other views. Selecting a link displays related information.

Detail
Start of changeA display showing a selection of detailed attribute information for a particular instance of a resource in one or two-column form. Attributes may be displayed in input fields so that the fields can be altered. In a detail display the information consists of attribute label, attribute value, and optional annotation.

Attribute labels can be links to other views.

Attribute values can be modifiable to allow you to enter your own values.

See Figure 3 for an example of a single-column detail view.

End of change
Confirmation Panel
This display is similar to a detail display and asks you to confirm that you want the action you requested to be applied to the selected resources.

The confirmation panel may contain the following buttons:

Table 3. Confirmation panel buttons
Button Meaning
Yes to n remaining Perform the action for this and all the remaining resources in the selection list; where n is the number of records remaining.
Yes Perform the action for this resource only and display the details of the next resource in the selection list
No to n remaining Cancel the operation for this and for all remaining resources in the selection list; where n is the number of records remaining.
No Do not perform the action for this resource and display the details of the next resource in the selection list

A confirmation panel may include parameters for some actions. It may be possible to select check boxes or radio buttons, or type a value into an input field to specify parameters for an action. Required parameters are marked with the icon  Required parameter icon. Figure 4 shows an example of a confirmation panel.

Attributes

The various types of forms may contain attributes that appear mainly as a simple textual representation of the information contained in an instance of a CICSPlex SM resource. Attributes may also appear as graphical presentations, for example, as warning lights or bar gauges.

All the attributes on tabular displays are display only, but detail forms can contain interactive controls that allow you to enter your own values.

For example, you may want to change the priority of a local transaction. You could select the transaction name from your view of local transactions. This may take you to the detail view of the transaction. You can now enter the priority in the Priority entry field if available, select the check box next to the entry field, then select the Set button or the button that you use to apply your changes, to change the value.

For more information see Modifying attributes and entering parameters.

Parameters

Parameters may appear only on confirmation panels and may be specified for an action. For example, on a CICS region shutdown confirmation panel, see Figure 4, you may have the opportunity to specify the normal, immediate or takeover parameters for the shutdown action. For more information see Modifying attributes and entering parameters.

Selection lists and entry fields

Attribute and parameter values are entered on views using selection lists and entry fields as follows:

Selection lists
Selection lists contain a complete list of values available to the user for a given attribute or parameter, on a view. A selection list enables you to select the appropriate attribute or parameter value from a list.
Start of changeDynamic selection listsEnd of change
Start of changeCertain attributes and parameters in entry fields in task guides, tabular and detail views are capable of generating dynamic selection lists. Fields capable of generating a selection list, are marked with the icon
generate dynamic selection list
to the right of the text input box. For resource input fields clicking the icon opens a screen like this: The valid values are displayed on the screen in tabular form sorted by resource type. To make a selection from the list you just select a radio button and click OK.

Selection list screens include an entry field containing the value currently being used to filter the list. To use a new filter, type a new value in the entry field and click Refresh.

Filters and context and scope fields are not able to generate dynamic selection lists.

Attribute selection list screens show all, or a filtered subset, of the attributes for a base table sorted by attribute name. They are used mainly for evaluation definition creation.

You can reduce the number of values displayed in a selection list by specifying filter values. These filters differ from filters as they normally occur in the WUI as they use only the = (equals) operator. You can type a generic value as the value for the attribute using the wildcard symbols * (asterisk) and + (plus sign) in the usual way, for example DW*. On a selection list screen you can then alter the values displayed in the list by modifying the filter value that appears in the box at the top of the screen.

Note:
If you type in a value that does not contain generic characters, this value is still used as the filter regardless of whether any values will be displayed in the selection list.
End of change
Entry fields
Entry fields allow the user to type in an attribute or parameter value. Fields that are case sensitive are marked with the icon  Case sensitive field icon.

Links

A link allows you to connect a field in one view with related information in another view. Links can originate from the following locations:

There are two types of links:

Link fields are highlighted in the normal manner for your web browser.

Annotation

At various places on a display, extra information can be shown in the form of a fixed annotation. Annotations may be used to show any brief notes you require.

View and menu annotations
These are applicable on any view or menu and appear below the data display for views or above the items of a menu.

For example, in the menu shown in Figure 6 the menu annotation is, 'Welcome to your Home menu. Please select a task from the following list. Use the 'Help' link for further information.'.

Attribute annotation
On detail views and confirm panels there may be a brief note about each individual attribute or parameter. The attribute annotation appears to the right of the attribute concerned.
Menu choice annotation
A menu choice annotation appears below the menu choice.

For example, in the menu shown in Figure 6 the sentence 'Display list of active CICS regions.' under menu choice 'CICS regions', is the menu choice annotation.

Action and confirm buttons

Action buttons are often displayed on views at the bottom of the work area. These include:

Action buttons

Action buttons can either:

For detail views, the action is performed on the resource displayed on the view. However, for tabular views, you can mark multiple records for an action, by selecting the check boxes displayed in the first column. If you prefer to perform the action on all the records, you can use the Select all icon. You can also use the Deselect all icon to clear your selection. The number of records selected on tabular and summary views is displayed above the tabular information as ' n records on n pages'.

If you mark more than one record for an action, the behavior depends on the type of action as follows:

Direct action requiring no confirmation
The action is carried out for all marked records. When the operation is complete, the view is redisplayed with all the check marks reset.
Actions requiring confirmation panel
The confirmation panel is displayed for the first marked record, containing at least one of the Yes, No, Yes to n remaining, and No to n remaining buttons. If the Yes or No buttons are selected the action is performed or not, as appropriate, and the confirmation panel is displayed for the next marked record, and so on. If the Yes to n remaining action is selected the action is carried out for all remaining marked records.

When the operation is complete, all check marks are reset.

Help link

This is a link to special on-line help documents and is optional. This help is called the customizable view and menu help. For information about the customizable view and menu help see Customizable view and menu help.

[[ Contents Previous Page | Next Page Index ]]