FDRMOVE Console commands and ISPF interface

FDRMOVE Console Commands

An FDRMOVE job accepts STOP(P) and MODIFY(F) commands from the console.

STOP and CANCEL Commands

To stop FDRMOVE, issue the STOP(P) command with the name of the FDRMOVE job

P job

FDRMOVE finishes moving all data sets that are actively being moved, and then terminates cleanly.

You can also terminate an FDRMOVE job with a console CANCEL(C) command. However, the first CANCEL(C) you issue is intercepted and acts as if a STOP(P) command was entered. Message FDR267 is issued to tell you that you can cause immediately cancellation by entering a second CANCEL(C) command.

We recommend against canceling an FDRMOVE job. Data sets that were being moved at the time of the CANCEL(C) may be left in an unknown state. It is better to STOP(P) the job and let it finish gracefully.

If a FASTMOVE job has submitted the FDRPAS job to move volumes to the transit stations, stopping the FASTMOVE job also stops the FDRPAS job, but only after all volumes have been returned to their original devices (see TRANSITRETURN=NO below).

If you submitted the FDRPAS transit station job independently or you had to cancel the FDRMOVE job, you can also issue a STOP(P) command to the FDRPAS job.

MODIFY Status Command

You can request the status of an FDRMOVE job by entering:

F job,STATUS (or just STA)

For a MOVE job, this displays the volumes that still have data sets to be processed, the active (enqueued) data sets for which the step is waiting and a summary of data sets processed. Here is a sample of the STATUS output for MOVE:

For a FASTMOVE job, this displays the status of each volume still containing data sets to be processed (in a transit station or not), active (enqueued) data sets and a summary of data sets processed. Here is a sample of the STATUS output for FASTMOVE:

On the volume line, the source and target DASD manufacturer and serial number are shown (for example, IBM76421). If a volume is in a transit station, the source and target IDs are the same. The “HIGHEST SEQ#” shows the status of multi-volume data sets on the volume; a value of 1 indicates no multi-volume data sets were found, but a value greater than 1 indicates the highest sequence number found on this volume. If you locate the highest sequence number displayed for any volume, this indicates the minimum number of NVOLs you need to move these multi-volume data sets. The sequence number may be followed by “NOIX” indicating that there is no active VTOCIX on the volume; this impacts FDRMOVE performance when it is scratching data sets from the volume, so you may wish to create a VTOCIX.

For both types of STATUS displays, the active data set display shows how many jobs currently hold the SYSDSN enqueue on the data set, and the first few job names are shown.

The display may also show “* CHECK ERROR MESSAGES *” if any error messages have occurred, or “* MOVE IS SUSPENDED *” if the job has been suspended.

STATUS displays a maximum of 100 lines in your JOBLOG (these may be echoed on your console). The STATUS is also put to SYSPRINT, displaying up to 1000 lines.

If you want to limit the volume status without details on the data sets, enter:

F job,STATUS NODSN

If you want to limit the volume status to certain volumes, enter:

F job,STATUS VOL=vol

“vol” can be a specific volume serial number, a volume serial number prefix followed by an asterisk (ABC*), or just an asterisk to display all volumes (the default).

You can specify both parameters, in either order, for example,

F job,STATUS VOL=vol,NODSN

Console MODIFY SUSPEND and RESUME

You can issue console commands:

F job,SUSPEND

or

F job,RESUME

To any active FDRMOVE or FDRPAS TRANSIT job. SUSPEND completes any active operations before going into a suspend state. RESUME starts the job going again.

SUSPEND to an FDRMOVE job finishes any existing MOVE task and does not start any new move task until a MODIFY RESUME. This allows the user to have an FDRMOVE job running for a long time, but have it moving data sets only during certain periods of time. For instance the user does the SUSPEND at 8AM and resumes it 12AM the next morning so that the moves are only taking place between 12AM and 8AM overnight. The SUSPEND can also be done from the FDRMOVE ISPF panels.

If the SUSPEND/RESUME is issued to the FDRPAS TRANSIT job, all active swaps to transit complete and no new ones start until the RESUME is done. This is different than the SUSPEND/RESUME command on the FDRPAS ISPF panels that temporary stop any tracks from being copied on active swap volumes.

MODIFY TRANSITRETURN Command

To dynamically modify the value of TRANSITRETURN=, issue the MODIFY(F) command, specifying the job name of an FDRPAS “SWAP TYPE=TRANSIT” job:

F job,TRANSITRETURN=NO

By default, FASTMOVE returns the source volumes to their original DASD devices after FASTMOVE is done with them. This option causes FASTMOVE to leave the source volumes in the transit station. It is the same as specifying TRANSITRETURN=NO on the SWAP statement.

If you terminate a FASTMOVE job (see the STOP(P) command described in “STOP and CANCEL Commands” in Section325.10), the FASTMOVE job automatically terminates the associated FDRPAS job, but only after FDRPAS has moved all volumes back to their original devices. If the FASTMOVE job has not completed all data sets and you intend to restart it later, you should use this procedure:

1. 87_ListNumber_1010268  1. Enter a console command:

F pasjob,TRANSITRETURN=NO

1. 87_ListNumber_1010269  2. Enter a console command:

P movejob

This terminates the FASTMOVE job (after it finishes any data sets actively being moved) and terminates the FDRPAS job, leaving any volumes that are in the transit stations in those stations. Later when the FASTMOVE job is restarted, FDRMOVE recognizes that the volumes are already in the same control unit as the targets, and does not move them again. As long it is run on the same LPAR and an intervening IPL has not occurred, it returns the volumes to their original devices.

FDRMOVE ISPF Interface

The FDRMOVE ISPF interface allows you to monitor FDRMOVE operations on the system where your TSO session is logged on.

Invoking the FDRMOVE ISPF Dialogs

The FDRMOVE ISPF dialogs are integrated with the ISPF dialogs of FDR, the Compuware Corporation DASD management system. If you have installed the FDR ISPF dialogs at a release level matching the level of FDRMOVE that you are using, your FDR or ABR main ISPF menu has an option “M” for FDRMOVE. If so, you can skip the invocation of ABRALLOC shown below and use that option to invoke the FDRMOVE 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 FDRMOVE in use, then use the following procedure:

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

EXEC 'fdrpas.clist.library(ABRALLOC)'

Specifying the name of the FDRPAS CLIST library that was installed during the installation of FDRPAS and FDRMOVE (see Invoking the Installation ISPF Dialog (Panel A.I)). This allocates all of the required FDRPAS ISPF libraries and invokes the ABR dialogs (including FDRMOVE).

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 “M” to monitor FDRMOVE. Other options are used for FDRABR and other components of the FDR DASD management software. Option “I” is used during installation of FDRPAS as described in Invoking the Installation ISPF Dialog (Panel A.I).

FDRMOVE Panel

This panel is displayed by the “M” option. It is used to monitor FDRMOVE jobs, using MOVE or FASTMOVE, with information similar to the console F movejob,STATUS described earlier. The FDRMOVE panel has these input fields:

Display DSN

Is set to YES or NO and controls whether the display contains lists of data sets that FDRMOVE is waiting to move. YES is the default

Jobname

Can be used to limit the display to certain FDRMOVE jobs if more than one is running. You can specify a specific FDRMOVE job name, a job name prefix followed by an asterisk (MOVE*), or just an asterisk to display all FDRMOVE jobs (the default).

Vol

Can be used to limit the display to certain volumes that FDRMOVE is processing. You can specify a specific volume serial number, a volume serial number prefix followed by an asterisk (ABC*), or just an asterisk to display all volumes (the default).

Refresh

Enter a count (0 to 99) and the FDRMOVE display is refreshed every few seconds until the count goes to 0 again.

The “Display DSN” and “Jobname” fields are remembered in your ISPF profile for the next time you invoke the panel.

The ISPF panel accepts a single command on the COMMAND line. You may enter “command job” where “command” is either “STOP”, “SUSPEND”, or “RESUME” and “job” is a specific FDRMOVE job name or a prefix (for example, “STOP MOVE*”). The STOP, SUSPEND, and RESUME commands verify that the selected job names are FDRMOVE jobs and internally issue the appropriate STOP, SUSPEND, or RESUME command for each one.

8FDRMOVE Data Set Move – Panel A.M

In the example above, the FASTMOVE job has 84 data sets to move from three DASD volumes. Data set names are not yet displayed because the volumes are not yet in the transit stations.

The FASTMOVE job has requested that the FDRPAS transit station job move the three volumes. Two volumes are being actively moved to their transit stations, and one is waiting move. Note that the display shows the vendor and serial number of the input and output DASD subsystems.

As soon as each volume gets to its transit station, FASTMOVE begins testing the status of the SYSDSN enqueue on each selected data set. As soon as the data set is no longer active, FASTMOVE moves that data set (using “instant replication” technology).

FDRMOVE Data Set Move – Panel A.M

In the example above, the FDRPAS transit station job has completed moving the first two volumes to the transit stations and is still moving the third volume. Seventy (70) of the data sets on those two volumes were either inactive when the volume reached the transit station or became inactive sometime before this display was requested.

Since “Display DSN” is set to YES, it displays each data set that is still active. It also shows the number of jobs or tasks that hold the SYSDSN enqueue on the data set and lists the first few job names.

Once the display shows that all volumes are in transit stations, you see the active data sets that remain and the jobs or tasks that own them. You can then shut down those applications. FASTMOVE tests the enqueue every few seconds, and moves the data set with instant technology as soon as it becomes free.

For a MOVE job, the display is similar except that there is no transit station information. You can still see the data sets for which MOVE is waiting and decide when you will free them. As described in FDRMOVE Target Volume Initialization, you can let a MOVE job run for a long time and it moves data sets (using normal I/O) as soon as they become free. You can monitor the remaining data sets and may choose to terminate the MOVE job and move the remaining data sets with FASTMOVE.

The display may also show “* CHECK ERROR MESSAGES *” if any error messages have occurred, or “* MOVE IS SUSPENDED *” if the job has been suspended.

Important

FDRMOVE processes all data sets selected from a given volume in parallel, so the data set count shown on the display does not change until FDRMOVE has finished all selected data sets on the volume.