FDRPAS ISPF interface

The FDRPAS ISPF interface allows you to initiate, monitor, and control FDRPAS operations on the system to which your TSO session is logged on. You can:

• Monitor active swaps
• Initiate SWAP, SWAPDUMP, MONITOR, SIMSWAP, and SIMSWAPMON tasks
• Confirm swaps that specified CONFIRMSWAP=YES or CONFIRMSPLIT=YES
• Suspend and resume active swaps
• Terminate active swaps
• Reply to certain FDRPAS messages
• Display FDRPAS history records
• Display basic information about any DASD devices in your installation, selecting them by unit address, volume serial number, subsystem ID, subsystem serial number, or SMS storage group.

Invoking the FDRPAS ISPF dialogs

The FDRPAS ISPF dialogs are integrated with the ISPF dialogs of FDR, the BMC Compuware Corporation FDR DASD management system. If you have installed the FDR ISPF dialogs at a release level matching the level of FDRPAS that you are using, your FDR or ABR main ISPF menu has an option “P” for FDRPAS. If so, you can skip the invocation of ABRALLOC shown below and use that option to invoke the FDRPAS dialogs.

If you do not have an appropriate level of the FDR dialogs installed, or they are at a lower release level than the level of FDRPAS in use; then use the following procedure:

Go to ISPF option 6, or exit ISPF to TSO READY mode, and issue this command:

 EXEC 'fdrpas.clist.library(ABRALLOC)'

specifying the name of the FDRPAS CLIST library that was installed during the installation of FDRPAS (see Electronic Installation). This allocates all of the required FDRPAS ISPF libraries and invoke the ABR dialogs (including FDRPAS).

If you issued the ABRALLOC from TSO READY, you see a standard ISPF main menu with an additional option “A” (for ABR). If your installation has modified your ISPF main menu, this may look considerably different than you are normally used to seeing. This ISPF menu looks something like this:

ISPF Primary Option menu

Select option “A” on the Option line, as shown and press Enter to display the FDR/ABR primary options menu.

FDR Primary Options Menu

The FDR primary options menu looks similar to this:

FDR Primary Options menu – Panel A

Select option “P” to monitor and control FDRPAS. Other options are used for FDRABR and other components of the FDR DASD management software. Option “I” is used during installation of FDRPAS (see Installation & Maintenance).

FDRPAS panel

This panel is displayed by the “P” option. It is used to initiate, monitor, and control FDRPAS operations on the system to which your TSO session is logged on.

FDRPAS – panel A.P

You can:

• Monitor active swaps.
• Generate JCL streams for operations such as SWAP, SWAPDUMP, CONFIRM, MONITOR, SIMSWAP, SIMSWAPMON, AutoSWAP, and HyperSwap.
• Confirm swaps where CONFIRMSWAP=YES or CONFIRMSPLIT=YES is specified.
• Suspend and resume swaps.
• Terminate active swaps.
• Reply to certain FDRPAS console messages.
• Display FDRPAS history records.
• Display basic information about any DASD devices in your installation, selecting by unit address, volume serial number, subsystem ID, subsystem serial number, or SMS storage group.

Positioning the cursor on “Menu” and pressing Enter displays a “pull-down” list of available commands that can be selected or typed on the command line or the command area of each row.

FDRPAS – Command pull-down menu

In the “pull-down” menu, the first column are the commands:

Active

Display volumes currently being processed by FDRPAS.

COnfirm

Respond to confirm volumes waiting for CONFIRMSWAP or CONFIRMDUMP.

Message

Display a panel where confirmation messages can be replied to.

SUspend

Suspend the copy between the source to the target volume.

REsume

Resume the copy between the source and the target volume.

ABORT

Immediately terminate an active swap.

Options

Display the Options panel.

HIstory

Get history for previous swaps.

SOrt

Display a panel where sort criteria for fields are specified.

The second column is used to generate batch jobs:

SWAP job

Generate a SWAP JCL stream.

SWAPDUMP job

Generate a SWAPDUMP JCL stream.

CONFIRM job

Generate a CONFIRM JCL stream.

MONITOR job

Generate a MONITOR JCL stream.

SIMSWAP job

Generate a SIMSWAP JCL stream.

SIMSWAPMON job

Generate a SIMSWAPMON JCL stream.

AutoSwap job

Generate an AutoSWAP JCL stream.

HYPERSWAP job

Generate a HyperSwap JCL stream.

The third column has the commands:

CLear

Clear all volume entries in the display. This command is used to clear all the values on the panel so you can start fresh.

RESEt

Clears the “swap generated” message in the status field. This command is used to reset the status field after generating a Swap job. This status field is set on the panel to prevent a duplicate MOUNT statement for a previously generated volume being re-generated. If the previously generated Swap JCL is discarded and not used, the RESET command can be used to reset the status field allowing the MOUNT statement for the volume(s) to be re-generated.

To execute a command from the Menu “pull-down” list, place the cursor next to the desired command and press Enter.

The short forms of the these commands are shown by the underlined letters.

If you simply press Enter, it checks to see if there are any swaps in progress on this system. If active swaps were found, they are automatically displayed, such as:

FDRPAS – Panel A.P – Format 1

You have several options:

• As long as there are no volumes displayed on the screen, you can simply press Enter to display any FDRPAS swaps that are active on this system (either SWAP tasks or MONITOR tasks).
• You can also request that volumes that are not currently involved in a swap be added to the display; this can be useful to initiate swaps or to verify the current location of selected volumes. Details are later in this section.
• If there are already volumes displayed, type the “Active” command (or just “A”) on the Command line to add any additional active swaps to the display.
• If the display currently contains at least one volume that was added to the display because it was active (by pressing Enter on a empty screen or by typing the “Active” command), then pressing Enter again scans for active volumes again and adds any newly active swaps to the display.
• If the display currently contains only volumes that were added by specific request, then pressing Enter simply updates the status of the displayed volumes, and does not check for active swaps.

If you just keep pressing Enter, the panel displays all active swaps, and adds swaps that later became active. Completed swaps remain on the display. However, note that if a swap begins and ends between two presses of the Enter key; then the panel never sees the active swap and does not add it to the display.

Alternately, you can type a volume serial prefix, a unit address prefix, an SSID, or an SMS storage group to display all of the volumes/devices selected, whether active or not. Details are later in this section. Pressing Enter updates the status of the displayed volumes but does not automatically add any active swaps of other devices (unless you type the “ACTIVE” command). This is preferable when you are swapping all DASD volumes on a control unit (SSID) or in a range of addresses, since all those DASD volumes are constantly displayed. You can easily see which ones have active swaps, completed swaps, or have not been swapped.

The three display formats

The ISPF dialog supports three display formats.

Display format 1, the default format, shown on the previous page, has one line of information about each volume. You can, of course, scroll up and down to view the complete list if it extends beyond one page.Notice that in the upper right of the default format it says “Panel: 1 of 3”. This indicates that the default format (panel format 1) is in use.

You can switch display formats by using the PF11 and PF10 keys, or the “RIGHT” and “LEFT” commands. The FDRPAS dialogs remember what format you were using when you last exited from the dialog and use that format again when you enter the FDRPAS dialog again.

Pressing PF11 once selects display format 2, which uses two lines per volume, for example,

FDRPAS – Panel A.P – Display Format 2

Pressing PF11 again selects display format 3, which uses five lines per volume, for example,

FDRPAS – Panel A.P – Display Format 3

Pressing PF10 returns to formats 1 and 2.

Format 1 is shown in the examples in the rest of this section.

Adding volumes to the display

You can add additional volumes to the display, selecting volumes by the volume serial, unit address, subsystem ID (SSID), control unit serial number, SMS storage group or jobname. The last four can be used only if you are using a panel format that includes those fields.

On a blank line (or even a line that currently displays a volume if you no longer want to see it), tab to the field that you wish to use for selection and type the appropriate value. If a complete volume serial or unit address is entered, only that one volume is displayed. If you type an SMS storage group, SSID, or serial number, all volumes matching that value are displayed. The SSID or serial number is a convenient way to display all volumes in an existing DASD subsystem so that you can swap all or some of them to new hardware; it can also be used to verify when all volumes have been swapped off that subsystem.

For example, if you type a controller serial number (CU Serial):

FDRPAS – Panel A.P – adding volumes to the display

and press Enter.

FDRPAS – Panel A.P – Volumes added to the display

It displays all volumes in the DASD subsystem with that SSID. As many as fit on the screen are displayed. You may need to scroll up and down (PF7 and PF8 or the Up and Down commands) to see the entire list.

Wild card characters can be used to select multiple volumes, units, storage groups, or control units. An asterisk (*) is the only supported wild card character. If it appears in the middle of a selection string, it represents exactly one character, while if it appears at the end it represents one or more characters.

For example,

• A volume serial number mask of **DB* selects all online volumes with serials of xxDBxx.
• A unit address mask of 12* selects all online volumes with addresses of 12xx.
• A storage group name of DB**3 selects all online volumes in SMS storage groups with names of DBxx3.
• An SSID of *3* selects all online volumes in subsystems with an SSID of x3xx.

ISPF line commands are supported for inserting and deleting entries in the display. In the “Command” column, next to any entry, type:

D

to delete a volume from the display.

I

to insert a blank entry in the display; it can be modified to add more volumes to the displayed volume list.

Sorting and filtering the display

Type the SORT command on the COMMAND line to sort the displayed volumes and/or filter the display based on STATUS values. The SORT command displays this selection screen:

FDRPAS – Panel A.P – SORT command

In the first section, place a digit in the SEQ field for each field on which the display is to be sorted; the field with SEQ of 1 is sorted first, then the field with SEQ of 2, and so on. Place an “A” (ascending) or “D” (descending) in the ORDER field to specify the sort order (“A” is assumed if not specified). Note that sorting on the STATUS field, ascending, places ACTIVE swaps first.

We recommend that sorting on STATUS (1) and VOL (2) provide a useful view of your volumes, especially if you have selected a range of volsers, device addresses, or an SSID to display.

In the second section, blank out the “S” in front of any values for STATUS that you do not want to see. Only those volumes with a status for which “S” is still present are displayed when you press End (PF3) to return to the status screen. If one or more values have the “S” blanked out, the status screen shows the text “*ROWS EXCLUDED*” to remind you that you have filtered the display.

The values you fill in on this screen are remembered in your ISPF profile and used the next time you re-enter the FDRPAS dialogs. To change them, you must use the SORT command again and modify the values.

Monitoring FDRPAS

When active swaps are displayed, you can monitor their progress. The display looks like:

FDRPAS – Panel A.P – Monitoring Progress

The status of ACTIVE indicates that the swap copy is in progress. In this example, CONFIRMSWAP indicates that CONFIRMSWAP=YES was specified on the SWAP request; when the volumes are synchronized, the swap waits, copying newly updated tracks as necessary, until this panel is used to confirm that the swap is complete. If CONFIRMSWAP is not present, the swap is automatically completed when the volumes are synchronized.

The status area may contain other messages. For example, if the SWAP is waiting for a reply (message FDRW01, or FDRW68), it indicates so (for example, WAIT FOR CONSOLE REPLY FDRW68 CAUTION REQUEST). I/O ERROR ON TARGET indicates that SWAPIOERR=RETRY and an I/O error while copying tracks has caused the swap to retry the error periodically until resolved or aborted.

If the swap is active, the end of the status area shows the percent(%) of the tracks that need to be copied during this pass. If there were updates to the volume during the copy phase, the value goes to 100% and then resets to the percent(%) of the tracks currently being recopied.

On panel 2 of 3, the second line shows the number of the copy pass that is currently executing (see Phase 3: Copy), the percentage complete of the pass, the total number of tracks to copy in the pass, and the number of tracks already copied in the pass. “Updated” indicates the number of tracks that have been updated on the source volume during the current pass, on this system; these tracks (plus those found updated by other systems) are copied in the next pass.

On panel 3 of 3, the next two lines show, for the source volume and the target device, the number of RESERVE macros that have been issued against them (the target always shows at least 1, issued by FDRPAS), the IOSLEVEL, and the current I/O pacing value. You can over type the target pacing value for any active volume to dynamically change the I/O pacing in use (see  PACEDELAY= for details).

Press Enter to update the information displayed. Alternately, over type the number after REFRESH with a value. The screen is updated automatically, every two seconds, until this value counts down to zero; the two second refresh interval can be changed on the FDRPAS options panel shown later in this section.

Once the volumes in a swap with CONFIRMSWAP=YES have been synchronized, the display looks like:

FDRPAS – Panel A.P – CONFIRMSWAP

Use the CONFIRMSWAP command (short form CO) to confirm the swaps and cause FDRPAS to complete them. You can:

• Type it in the “Command” column next to each volume to be confirmed.
• Type it on the COMMAND line at the top of the screen. This applies to every volume on the display (even those that may not be currently visible) that is in WAIT FOR CONFIRMSWAP status.

Once you enter the command, the display looks like:

FDRPAS – Panel A.P – CONFIRMSWAP entering CONFIRM

Only the volumes to be confirmed are displayed. Press Enter to complete the swap, or press PF3 (End) to ignore the confirmation. Note that the word “CONFIRM” is filled in on the command field for each volume; volumes can be blanked out before pressing Enter to exclude them.

Once the swap is confirmed, FDRPAS completes the swap and the display is:

 FDRPAS – Panel A.P – Completing the Swap

The unit address, SSID, and serial number of the target device are now displayed.

This is also the format of the display for completed swaps when CONFIRMSWAP=YES is not used.

Initiating SWAP Tasks

You can also initiate SWAP and MONITOR tasks from the FDRPAS ISPF panels. If multiple systems are involved, FDRPAS MONITOR tasks for the offline target volumes must be started on every system, before the SWAP task starts.

FDRPAS – Panel A.P – Initiating SWAP Tasks

To initiate a swap, display one or more inactive online volumes (not currently involved in a swap) as described earlier. In the column “Swap to Offline Unit”, fill in a 4-digit device address for the offline target volume that the online volume is to be swapped. When complete, type the SWAP command (or just SW) for a SWAP operation or DUMP (or just DU) for a SWAPDUMP operation. You can:

• Type it in the “Command” column next to each volume to be swapped as shown above.
• Type it on the “COMMAND” line at the top of the screen. This applies to every volume on the display (even those that may not be currently visible) that is in INACTIVE status with a target device filled in.
• Place the cursor on the SWAP command in the “pull-down” menu.

This creates one or more FDRPAS batch jobs for the requested swaps. See the description of the options on the next page to understand how the FDRPAS batch jobs are managed.

If you are swapping many volumes, for best performance you should spread the SWAP tasks across several systems, so you may need to add JCL or control statements to route the jobs to the systems to do so. If multiple systems are involved, you must start MONITOR tasks on every system before initiating the SWAP task (you can start MONITOR tasks from the ISPF dialog or have the FDRPAS job submit the MONITOR tasks by using the //PASJOB DD statements).

If you are swapping volumes from one control unit to another, here is an easy way to initiate the swaps with a minimum of typing. On an empty line, type the address mask for the old control unit, for example, 17*. On the same line, type the address mask of the new control unit in the “swap to” column, for example, 21**. It displays all the volumes that are still online in the old address range (1700-17CF), and propagates the target address of 21** to each entry. As explained under “SWAPUNIT=” , FDRPAS swaps each 17xx DASD volume to the matching 21xx target volume.

Setting FDRPAS Options

You can set the options to be used during the SWAP or SWAPDUMP operation by typing the OPTIONS command beforehand to get this panel:

FDRPAS – Panel A.P – OPTIONS Command

You can over type any of the options shown on the previous panel. The values are saved in your ISPF profile for use with all subsequent SWAP, SWAPDUMP, SIMSWAPMON, and SIMSWAP operations started by this ISPF user id.

The options on the first part of the panel correspond to options that can be specified on a SWAP,SWAPDUMP, SIMSWAPMON, or SIMSWAP statement. See SWAP, SWAPDUMP, SIMSWAP, SIMSWAPMON Statements for a description of these options.

The options on the bottom (“Other Options”), except for the option “INTERVAL”, control the submission of swaps from the ISPF panel:

MAXVOLS=

nnnn

Specifies the maximum number of volumes that the panel consolidates into a single FDRPAS SWAP task (address space) when you enter the SWAP or SWAPDUMP command and request that multiple volumes be swapped. It creates an FDRPAS batch job with one SWAP/SWAPDUMP statement and multiple MOUNT statements. If the number of volumes requested at one time is larger than MAXVOLS=, then multiple FDRPAS batch jobs are created, with up to MAXVOLS= volumes in each one. Each FDRPAS batch job processes its assigned volumes serially, one at a time, unless MAXTASKS= is greater than 1.

Default: 1 (one FDRPAS batch job per volume) and the maximum is 250.

MAXTASKS=

nnn

Equivalent to the MAXTASKS=, operand on the SWAP and SWAPDUMP statement (see MAXTASKS=). When a SWAP or SWAPDUMP of more than one volume at a time, this controls the maximum number of concurrent swaps that FDRPAS processes in a single started task (address space). MAXTASKS= has no meaning unless MAXVOLS= is set to a value larger than 1.

Default: 1 (process one volume at a time, serially) and the maximum is 100.

MAXACTIVE=

Equivalent to the MAXACTIVESWAPS= operand on the SWAP and SWAPDUMP statement (see MAXACTIVESWAPS=).

INTERVAL=

nn

The refresh interval, in seconds, used when you enter a value for Refresh on the main FDRPAS panel. Refresh counts down to zero, every “nn” seconds and automatically refresh the display. This allows the monitoring of FDRPAS operations without constantly pressing ENTER.

Default: 2.

WTOR=

Equivalent to the WTOR= operand on the SWAP and SWAPDUMP statement (see WTOR=).

AUTOSAVE=

Specifies whether the FDRPAS Plug & Swap panel should save the volume information between sessions or not.

5-DIGIT=

Display 5-digit device numbers in the panels.

Suspending and resuming active swaps

You can use the FDRPAS ISPF panel to temporarily suspend an active swap without terminating it and resume it later, if needed. While suspended, FDRPAS does not copy any tracks from the source volume to the target device, but it still monitors the source volume for updates. When resumed, FDRPAS again copies tracks.

Type the SUSPEND command (or just SU) in the “Command” column next to the active swap to be suspended. This can be done only on the system running the SWAP task (indicated by MAIN on the right hand). The status changes to SUSPEND. To resume, type the RESUME command (or just RE) next to any suspended swap.

FDRPAS – Panel A.P – Suspend Swap Tasks (Panel 3 of 3)

You can also reduce the overhead of FDRPAS without totally suspending copy I/O by over typing the target device pacing value. This value is the number of 1/100 seconds to delay between copy I/O's (each copy I/O typically copies 15 tracks). A pacing value of 5 or 10 significantly reduces FDRPAS overhead while allowing the swap to continue; however, it takes longer.

Terminating active SWAP tasks

You can use the FDRPAS ISPF panel to terminate an active swap, if needed.

Type the ABORT command (or just AB) in the “Command” column next to the active swap to be aborted. This can be done on a system running the SWAP task or a system running a MONITOR task for the volume.

FDRPAS – Panel A.P – Terminate Active Swaps

Replying to console messages

The panel displays SWAP tasks that are waiting for FDRW01 or FDRW68 replies, and allows you to reply to the message from ISPF instead of the console.

This example shows one task waiting for FDRW01 (because CONFMESS=YES was specified) and another waiting for FDRW68 (because the proper number of MONITOR tasks has not responded).

FDRPAS – Panel A.P – MESSAGE command

To reply, type the MSG command in the command area (or type MSG on the command line to invoke it for all swaps in the display that are waiting for message reply). You get this panel that shows the full text of each message. Type a reply in the appropriate area to reply to the desired messages.

 FDRPAS – Panel A.P – MESSAGE command response

Displaying SWAP history

If you type the HISTORY command (or just HI) on the command line of the FDRPAS panel, you can display FDRPAS history records, as shown above, for all volumes that have been successfully swapped by FDRPAS. See FDRPAS History Records for a description of History records.

FDRPAS – Panel A.P – HISTORY Command

The sample display above shows that volume HI17CD was swapped from address 17CD to 17CB on three systems, on the date and time displayed.

On the FDRPAS panel, you have several options for selecting the history records to be displayed:

• If no volumes are displayed on the panel, you can type HISTORY on the command line to display the most recent swap activity for every volume recorded in the history records. Alternately, you can type HISTORY ALL to display all swap activity for every volume recorded (for volumes that have been swapped more than once).
• If volumes are displayed on the panel, typing HISTORY or HISTORY ALL displays history only for the displayed volumes.
• If you type HISTORY followed by a volume serial number prefix, such as HISTORY TSO, on the command line, it displays history only for the volumes specified, regardless of whether volumes are displayed or not. You can also follow the prefix with the ALL option, such as HISTORY.