Creating and managing User Console views

This topic describes how to create and manage WebSphere MQ view layouts in the MainView Middleware Administrator (MVMA) User Console.

The ability to manage layouts enables you to define which columns should be shown on a Summary View, including its column sizes and sort order, and which objects should be shown in the Navigation Panel. The layouts can be easily selected according to your requirements.

Views are kept in a structured “layout”, and include a name, a set of column names (which map to properties for an object, such as “CurrentQDepth”), the size of each column (by default this is based on the existing CSS layouts in MVMA), a column sort and direction (i.e. ascending or descending), and a filter expression.

The layout structure is created manually using the Layout Editor (as described below), and can be used as required in various views, including the Navigation Panel (referred to as the WMQ Navigation Menu in the Layout Editor), in the User Console.

To create a view layout

1. From the options menu in the Global Actions Bar, select Manage Layouts.
   OR
   In any Summary View, click the layout selection menu and then select Manage Layouts....
   OR
   From the Navigation Panel, click the Edit Layout icon, located in the lower left corner.
   
   The Layout Editor is displayed.
   
2. In the General section, the View Type name is by default displayed with the name of the view you are currently in (from the drop-down list, select an alternative view type (if required)). Then define a name for the layout in the Layout Name field.
3. In the Filter section, select the relevant filter option and then enter the filter criteria.
4. In the Columns section, select the relevant columns from the Available list of columns (these columns will vary according to the view type you selected in Step 2).
   Note that if you want to select all the columns in the Available list, click . 
   Once you have selected the relevant columns, define their order by using the arrow buttons in the Selected list. In the Sort by field you can also choose a column to sort the display according to that column (in ascending or descending order).
5. In the Sharing section, the layout structure is displayed in JSON format. This can be copied and shared with other MVMA users, who can import this structure for their own use (as described below).
6. Click the Save icon to save the layout structure. This layout will now be available in the relevant views in the User Console (as described below).
7. Click the Close icon to exit the Layout Editor.

To import a view layout

1. From the options menu in the Global Actions Bar, select Manage Layouts.
   OR
   In any Summary View, click the layout selection menu, and then select Manage Layouts....
   
   The Layout Editor is displayed.
2. Click the Import icon. The Import Layout window is displayed.
3. Enter the relevant JSON layout structure. The following is an example of correctly structured JSON:
   {"name":"alias queues sorting","viewType":"aliasqueues","properties":[{"name":"AlterationDate","width":100,"sort":0},{"name":"AlterationTime","width":100,"sort":0},{"name":"BaseQName","width":100,"sort":0},{"name":"ClusterName","width":100,"sort":0},{"name":"ClusterNamelist","width":100,"sort":0},{"name":"DefBind","width":100,"sort":0},{"name":"DefPersistence","width":100,"sort":0},{"name":"DefPriority","width":100,"sort":0},{"name":"InhibitGet","width":100,"sort":1},{"name":"InhibitPut","width":100,"sort":0},{"name":"QDesc","width":100,"sort":0},{"name":"QName","width":100,"sort":0},{"name":"QSGDisposition","width":100,"sort":0},{"name":"QType","width":100,"sort":0},{"name":"Scope","width":100,"sort":0}],"filter":{"type":"wildcard","expression":""}}
4. Click Import.
5. In the displayed confirmation message, click OK. 
6. Click the Save icon to save the layout structure. This layout will now be available in the relevant views in the User Console (as described below).
7. Click the Close icon to exit the Layout Editor.

To use a view layout

1. In the relevant view, click the layout selection menu to display a drop-down list of available layouts defined for this view type.
2. Select the relevant layout. The view is refreshed with the selected layout.