Using the FDRPAS CMS command
If you choose to access the FDRPAS command from a virtual machine other than FDRMAINT, MAINT for example, one line should be added to the PROFILE EXEC to link and access the FDRMAINT 691 disk using the VMLINK command. Following is an example:
FDRPAS CMS command overview
The FDRPAS command is used to communicate with the FDRPASVM service machine. It can be followed by any of these keywords:
MONITOR TYPE SWAP devices (operands - to start monitoring swaps. The device addresses can be specified with wild-cards used by the z/OS version of FDRPAS (XXX*, XX*, or X*). The two operands that can follow are DURATION and SWAPDELAY.
MONSTAT - to display the status of monitoring and swaps on the FDRPASVM service machine.
QUIT - Exit the program if the FDRPASVM service machine is in an idle state (no active SWAP or SWAPDUMP tasks, nor volumes waiting for them).
STOP - to have the FDRPASVM service machine gracefully enter the idle state.
A complete description of the syntax for FDRPAS commands follows.
FDRPAS MONITOR TYPE SWAP syntax
The syntax of the FDRPAS MONITOR TYPE SWAP command is:
(DURATION n
SWAPDELAY m
DRAIN o
QUIET
FDRPAS MONITOR TYPE SWAP operands
- MONITOR TYPE SWAP DEV1 … DEVn
Send a MONITOR TYPE SWAP request to the FDRPASVM service machine for the specified target devices. Devices can be specified as specific devices or with a wild-card. To use a wild-card, type a one to three digit value followed by an asterisk. The digits are used to form the high order or leftmost part of the device number. For example, to request all devices from 4100 to 410F, type 410*. To request all devices from 4100 to 41FF, type 41*.
In order for a device to be used as a target device, it must be an ECKD DASD device that is online and free. Any devices not meeting these criteria are ignored. A message is sent from the FDRPASVM service machine with the number of devices found on the system that are eligible for use as SWAP targets from the devices specified. DURATION
n- Specifies the number of idle minutes that the volume watch thread executes; it does not include the time when participating in an active SWAP or SWAPDUMP. The volume watch thread terminates when it has been idle for a total of this many minutes.
Default: The volume watch thread runs until all devices have been swapped. It can be told to terminate after the completion of currently running swap operations by sending a STOP request to the FDRPASVM service machine with the FDRPAS command, or by entering the STOP command on the FDRPASVM service machine virtual console.- SWAPDELAY
m - Specifies the number of seconds (1-255) that the FDRPASVM service machine waits between scans of the eligible target devices it is monitoring to see if an FDRPAS SWAP task has selected one of them as a SWAP target.
Default: 5 seconds. This should be adequate unless you have a large number of systems participating in the SWAP process. - DRAIN
o - Specifies the minimum percentage of available page/spool space on this volume relative to total available page/spool space of the system, required to drain the volume. Up to a maximum of 75 maybe specified.
Default: 55 percent. - QUIET
This option notifies the service machine to operate in QUIET mode and not to generate messages regarding the I/O operation. This option should only be used at the direction of BMC Support.
FDRPAS MONSTAT syntax
The syntax of the FDRPAS MONSTAT command is:
Send a request to display the status of the FDRPASVM service machine. Message PASIUCSM016I is issued, showing the numbers of volumes that have been swapped successfully, have failed, are active, and are pending. There is more detail described for this message in PASIUCSM Messages.
FDRPAS QUERY syntax
The syntax of the FDRPAS QUERY command is:
ACTIVE | PENDING | SWAPPED | FAILED | IO
FDRPAS QUERY operands
QUERY
ACTIVE -Display the list of devices that are involved in active SWAP / SWAPDUMP / SIMSWAPMON operations.
PENDING - Display the list of devices that are being monitored and waiting for a SWAP / SWAPDUMP / SIMSWAPMON operation. Only the first 256 devices are displayed.
SWAPPED - Display the list of devices that have completed the operation and will no longer be monitored.
FAILED - Display the list a devices that have failed and will no longer be monitored.
IO - Display the list of devices that have I/O active. This command should only be used at the direction of BMC Support.
FDRPAS QUIT syntax
The syntax of the FDRPAS QUIT command is:
Send a QUIT request to the FDRPASVM service machine. The FDRPASVM service machine terminates if there are no volumes being monitored or swapped.
FDRPAS STOP syntax
The syntax of the FDRPAS STOP command is:
Send a STOP request to the FDRPASVM service machine. The volume watch thread stops monitoring devices for new swaps and terminates if there are no active swaps. If there are any active swaps, it waits for them to complete and then terminates.
FDRPAS VERSION syntax
The syntax of the FDRPAS VERSION command is:
Displays the version of FDRPASVM.