Viewing the output

The following figure shows an example of the panel when viewing a report.

HCD tries to display the entire configuration on one panel. If a report is too large for one panel, HCD divides the report into segments and shows each segment on an extra panel. If a CU report, for example, shows more than 8 control units, HCD shows the control units of the same type in one segment on an extra panel. You can move from segment to segment by using the Next and Previous function keys.

If a segment is too large for the panel, you can scroll upwards, downwards, to the left and to the right.

The following list describes specific function keys while viewing a graphical report.

F4=Jump

You can use this function only when you have displayed the graphical report using the task Create or view graphical configuration report on the Primary Task Selection panel. It displays the action list of the HCD dialog that contains the object you selected with the cursor. Any change made to the configuration on the action list will not be reflected in the graphical report when you return to it. Use the REFRESH command to reflect the changes made to the objects currently shown on the display (see Refresh Command).

F5=Zoom in

Makes the graphical display bigger, so you can see the details of an object. The position of the cursor identifies the lower left corner of the part you want to enlarge. If the cursor in not positioned, HCD takes the center of the currently displayed report.

F6=Zoom out

Makes the graphical display smaller, so you can see more of a report on one panel.

F7=Up

Scrolls upwards.

F8=Down

Scrolls downwards.

F10=Previous

Moves to the previous segment of a report, if any.

F11=Next

Moves to the next segment of a report, if any.

F19=Left

Scrolls to the left.

F20=Right

Scrolls to the right.

Save command

You can use the SAVE command to store a graphical configuration displayed on your screen in a member of a partitioned data set (PDS) in GDF format for printing with GDDM.

Before you use this command, the partitioned data set has to be allocated to ddname ADMGDF. The records of this PDS must have a record length of 400.

Specify SAVE (or just SA) and the member name, into which you want to save the data, on the command line. The syntax of the SAVE command is as follows:

>>-+-SAVE-+--member_name---------------------------------------><
   '-SA---'
 

member_name

specifies the name of the member to contain the graphical configuration you want to print. Use a different name for each SAVE command, otherwise the data will be overwritten. The name may be up to eight characters long.

Locate Command

You can use the LOCATE command to center and highlight a specific object of the report. When you locate a partition, channel paths, or coupling facility partition, the connections to the object are highlighted instead of the object itself.

Specify LOCATE (or just L) and the object you want to locate in the command line. For objects that are associated with another object (for example, CHPIDs that are associated with a processor), you have to specify this object as well.

Locating multiple objects with the same ID

The LOCATE command first searches for an object in the currently displayed panel. If the object is not found it starts with the first segment and continues to the right until an object has been found. To find the other objects with the same ID, use the + and - parameter of the LOCATE command. The + parameter searches for the next object to the right, the - parameter to the left.

The syntax of the LOCATE command is as follows:

>>-+-LOCATE-+--+-CF--processor ID-------------------+----------->
   '-L------'  '-+-CHPID--processor ID-+--object id-'
                 +-CU------------------+
                 +-DEV-----------------+
                 +-PART--processor ID--+
                 +-PR------------------+
                 '-SW------------------'
 
>--+-----+-----------------------------------------------------><
   +- + -+
   '- - -'
 

CF

Coupling Facility

CHPID

Channel path

CU

Control unit

DEV

Device

PART

Partition

PR

Processor

SW

Switch

Example

To locate CHPID 27 of processor SYSA, type

L CHPID SYSA 27

Refresh Command

When you jump to an action list using F4=Jump and change objects in this list, use the REFRESH command on return to the graphical display to refresh the graphic with the changes made.

REFRESH applies to all objects that were currently shown on the graphical report when pressing the F4=Jump key, that is, added objects or those, for which you changed the ID, will not appear in the refreshed graphic.

Valid abbreviation of the REFRESH command is RE.