MONITOR SWAP statement for remote SWAPDUMP

This section shows all of the operands of the MONITOR TYPE=SWAP statement, and discusses those that are only used for remote operations, or have special meanings or considerations on remote operations, or are particularly important on remote operations. Those that are not discussed have the same considerations as in MONITOR SWAP Statement.

MONITOR SWAP Statement Syntax

MONITOR SWAP Statement for Remote SWAPDUMP

This statement initiates an FDRPAS MONITOR task that monitors for FDRPAS SWAPDUMP tasks beginning a SWAPDUMP or SIMSWAPMON operation. It must be the first statement in the input; only one MONITOR statement is allowed per execution.

For remote SWAPDUMP, it is expected that the monitor jobstreams will be embedded in the PASJOB DD statement of the SIMSWAPMON and SWAPDUMP jobs, so that the SIMSWAPMON and SWAPDUMP jobs will submit the jobstreams as just-in-time monitors. Dynamic monitors are not recommended for remote SWAPDUMP.

The presence of the SUPERTARGET operand tells the monitor that this is a remote operation. On a local operation, the MOUNT statements for the monitor specify offline devices that are to be used as targets. On a remote operation, the target devices are located at a remote site and are not accessible to the monitor; the MOUNT statements for the MONITOR specify the online source volumes.

MONITOR SWAP Statement Operands for Remote SWAPDUMP

TYPE=

Must be specified on the MONITOR statement.

SWAP

Initiates a MONITOR task that monitors for a SIMSWAPMON or SWAPDUMP operation.

ALLOWPAV=

The ALLOWPAV= operand specifies whether the Parallel Access Volume (PAV) aliases for the source volume are disabled during the SWAPDUMP operation. (On a remote operation (REMOTEIP=), the PAV aliases for the target devices at the remote site are never disabled.)

NO

Indicates that the Parallel Access Volume (PAV) aliases for the source volume are disabled at the start of the SWAPDUMP operation and re-enabled after the SWAPDUMP operation completes.

YES

Indicates that the Parallel Access Volume (PAV) aliases for the source volume stay enabled during the SWAPDUMP operation.

Default: NO.

ALLOWPAV=YES is strongly recommended for remote SWAPDUMP. Since the operation is likely to run for a long time (days), it is important to continue to use facilities that enhance performance.

ALLOWPAV=YES needs to be specified on all of the SWAPDUMP and MONITOR tasks that you wish to leave PAV active.

ALLOWZHPF=

NO

At the beginning of a SWAPDUMP, FDRPAS temporarily disables zHPF on the volume being processed; FDRPAS turns zHPF back on at the end of the SWAPDUMP.

YES

FDRPAS does not disable zHPF during the SWAPDUMP process. Transport Control Word (TCW) commands used with zHPF are allowed throughout the operation.

Default: NO.

ALLOWZHPF=YES is strongly recommended for remote SWAPDUMP. Since the operation is likely to run for a long time (days), it is important to continue to use facilities that enhance performance.

ALLOWZHPF=YES needs to be specified on all of the SWAPDUMP and MONITOR tasks that you wish to leave zHPF active.

CANCELPROT=

No distinctive considerations for remote operations.

DURATION=

nnnn

Specifies the number of idle minutes that the MONITOR task execute; it does not include time that the MONITOR task is actively participating in a SWAPDUMP. The MONITOR task automatically terminates when it has been idle for a total of this many minutes.

When the jobstream for the monitor is embedded in the PASJOB DD statement of the SIMSWAPMON or SWAPDUMP job, so that the monitor is submitted as a just-in-time monitor, SIMSWAPMON or SWAPDUMP internally changes DURATION= to STOPINAC=. STOPINAC= has two additional features:

The DURATION is reset to the original value at the beginning of each cycle. If this were not done, the pauses between cycles could accumulate to reach the DURATION value, causing the monitor to terminate prematurely.

When the SIMSWAPMON or SWAPDUMP operation completes, the monitor stops immediately, instead of waiting for the DURATION period. This is particularly helpful at the end of a SIMSWAPMON, if you want to start the actual SWAPDUMP right away.

Default: The MONITOR task executes until it is terminated by a console STOP(P) command, or Canceled.

Specify DURATION=2.

DYNMON=

Do not specify DYNMON= on remote operations.

Dynamic monitors are not recommended for remote SWAPDUMP. It is expected that remote SWAPDUMP are set up with just-in-time monitors. With just-in-time monitors, templates for the monitor jobstreams are embedded in the PASJOB DD statement of the SIMSWAPMON and SWAPDUMP jobs; the SIMSWAPMON and SWAPDUMP jobs generate the MOUNT statements for the monitor jobs and submit the monitor jobs via the internal reader.

LARGESWAP=

nnnnn

Specifies a value slightly larger than the number of volumes being swapped, from 2000 to 16000. The purpose of this operand is to reduce the below-the-line CSA requirements. This operand should be used when FDRPAS is processing more than 2000 volumes at the same time with KEEPACTIVE=REPEAT, either in one job or in multiple jobs. For example, for 5000 volumes, specify LARGESWAP=6000. When LARGESWAP= specifies a value larger than the number of volumes being swapped, the requirement for below-the-line CSA is no more than 400 KB.

LARGESWAP= needs to be specified on all of the SWAP and MONITOR tasks running in the same time period.

LOGMESS=

YES

Messages are written to SYSLOG (and usually to an operator console) documenting that the SWAPDUMP is occurring, and has completed.

NO

No SYSLOG/console messages are written.

Default: YES.

Specify LOGMESS=NO. When the SWAPDUMP specifies KEEPACTIVE=REPEAT, and a large number of volumes are involved, the console messages generated by the default of LOGMESS=YES are liable to be excessive on cycles after the initial copy cycle.

MAXTASKS=

No distinctive considerations for remote operations.

PRINT=

ALL

Requests additional printout from the MONITOR task, including a detailed list of the tracks updated in each phase.

PRINT=ALL is intended for diagnostic purposes. Do not specify PRINT=ALL unless requested by INNOVATION.

SRVCLASS=

Allows you to override the service class assigned to the SWAP job by Workload Manager (WLM).

classname

The desired service class.

HIGHEST>

(Note the 8th character is a “greater than” sign.) Set the service class to the same class as the address space with the highest dispatching priority in the system that is X'F8' (248) or less, and that has a single performance period.

NULL

Do not change the service class assigned by WLM.

If SRVCLASS= is not specified, the default for MONITOR is as follows:

• If the service class assigned by WLM gives a dispatching priority of X'F0'(240) or higher, MONITOR does not change it.
• If the service class assigned by WLM gives a dispatching priority lower than X'F0' (240):
  • Set the service class to PRDBATHI.
  • If class PRDBATHI is not defined, take the action described for SRVCLASS=HIGHEST>.

SRVCLASS=SYSTEM is invalid, because FDRPAS is not eligible to be reset into the SYSTEM service class. However, SRVCLASS=SYSSTC is valid.

SUPERTARGET=

ST=

This operand is required for remote operations using TCP/IP.

uuuu

Specifies the z/OS device address of the “supertarget” device. This must be specified as a 4-digit address, with a leading zero if required. This device is used as a work and communication area by the SWAPDUMP and monitor jobs; the same supertarget must be specified for the SWAPDUMP job and all of its corresponding monitors. The supertarget must be connected to the main SWAPDUMP LPAR and all of the monitor LPARs, must be offline on all of those LPARs, and should not contain any needed data. The supertarget does not need to be initialized in any way. One supertarget can be used by many SWAPDUMPs at the same time. The supertarget should be a 3390-9 or larger; it does not have to be as large as the volumes being processed.

SWAPDELAY=

nnn

When SUPERTARGET is specified, SWAPDELAY= specifies the number of seconds (1 to 255) that FDRPAS waits between scans of the supertarget device to see if a new FDRPAS SWAPDUMP is starting.

Default: When SUPERTARGET is specified, the default for SWAPDELAY is 2 seconds. The default should be adequate unless you have a large number of LPARs participating in the SWAPDUMP process.

Do not specify SWAPDELAY= unless recommended by INNOVATION.

SWAPID=&&&

This operand is required (except under GENSWAP) when more than one SWAPDUMP or SIMSWAPMON job using just in time monitors is to run at the same time. (It is expected that remote SWAPDUMP operations are not under GENSWAP and always use just in time monitors.) FDRPAS uses the SWAPID value to relate each SWAPDUMP or SIMSWAPMON job to its associated monitors. Without SWAPID, a SWAPDUMP or SIMSWAPMON job does not submit a just in time monitor to an LPAR where a monitor is already running. With SWAPID, the SWAPDUMP or SIMSWAPMON job submits the just in time monitor to an LPAR unless a monitor with a matching SWAPID is already running there.

When the jobstream for the monitor is embedded in the PASJOB DD statement of the SWAPDUMP or SIMSWAPMON job, so that the monitor is submitted as a just-in-time monitor, SWAPDUMP or SIMSWAPMON internally replaces the &&& in the SWAPID= operand on the MONITOR TYPE=SWAP statement with the SWAPID value specified for the SWAPDUMP or SIMSWAPMON job. This ensures that the SWAPID values will match. Although it is acceptable to code a number for the SWAPID= operand on the monitor, it is not recommended. Specifying ampersands avoids possible errors and allows you to use the same MONITOR statement for all of the monitors in a migration.

A single ampersand (SWAPID=&) is sufficient unless the SWAPID value for the SWAPDUMP or SIMSWAPMON job is higher than 9. Two ampersands (SWAPID=&&) are sufficient unless the SWAPID value for the SWAPDUMP or SIMSWAPMON job is higher than 99.

Default: None. SWAPID is not needed when only one SWAPDUMP or SIMSWAPMON job runs at a time.