|********************************* TOP OF DATA ********************************|
| *** Display the Status of DASD and Tape Devices *** |
| |
| Command: DEVSERV Supported MVS Levels: XA|ESA |
| |
| Overview: The DEVSERV command is used to display the status of Direct |
| Access Storage Device (DASD) and tape devices. For a given |
| device or a group of devices the following information is |
| displayed: |
| - devices' logical mode |
| - number of data sets allocated on the volume |
| - volume serial number |
| - channel path id (CHPID) |
| - path status |
| - SMS-managed device status (requires MVS/DFP version 3) |
| |
| Syntax: |
| DS | PATHS|,ddd{,nn}|,ONLINE |,NOSYSM|,DUMP|,L={a }| |
| DEVSERV| P | |,ON |,NOS | | {cc }| |
| | SMS | |,OFFLINE| | | {cca}| |
| | S | |,OFF | | | | |
| |
| Operands: PATHS|P ***XA|ESA*** |
| Use this operand to display, via message IEE459I, the |
| status of specific devices. Any devices which are managed |
| by SMS are displayed, however no SMS information will be |
| shown. |
| |
| SMS|S ***XA|ESA*** |
| Use this operand to specify that the volume and storage |
| group status information is to be displayed, via message |
| IGDØØ1I, for devices managed by SMS. |
| |
| ddd ***XA|ESA*** |
| Use this operand to specify the 3 or 4 byte hexadecimal device |
| number of the device that the system is to display information |
| for. Replace ddd with any valid device number; optionally, |
| specify a "/" before the device number. When this operand is |
| used in conjunction with the S or SMS operand only SMS managed |
| devices will have their volume status and storage group |
| displayed. |
| |
| nn ***XA|ESA*** |
| Use this operand to specify the number of devices, |
| (count) starting at ddd, that are to have their |
| information displayed. Replace nn with a decimal |
| number from 1 to 32. If this operand is omitted than |
| only one device (ddd) will have it's information |
| displayed. |
| |
| ONLINE|ON ***XA|ESA*** |
| Use this operand to specify that only devices which are |
| online are to have their information displayed. If this |
| operand is omitted that both online and offline device |
| information is displayed. |
| |
| OFFLINE|OFF ***XA|ESA*** |
| Use this operand to specify that only devices which are |
| offline are to have their information displayed. If this |
| operand is omitted that both online and offline device |
| information is displayed. |
| |
| NOSYM|NOS ***XA|ESA*** |
| Use this operand to specify that the system should not |
| display definitions about the symbols contained in |
| message IEE455I. If you omit this operand than the |
| definitions for all of the symbols are displayed. This |
| operand is not valid with the SMS or S operand. |
| |
| DUMP ***XA|ESA*** |
| Use this operand to specify that after executing the |
| DEVSERV PATHS command the system is to request an SVC |
| dump. When used with the DUMP operand |
| the nn operand is ignored and the SMS or S operands |
| are not valid. |
| |
| L=a|cc|cca ***XA|ESA*** |
| The location operand can be used to route the summary |
| display to a specified console and/or display area. You |
| may specify the display area (a), console (cc), or both |
| (cca). If omitted the display is routed to the first |
| available display area or message area of the console |
| which submitted the command. |
| |
| |
| Examples: The example below will display the status of a DASD with |
| the device number 16Ø: |
| |
| DEVSERV P,16Ø or DS P,16Ø |
| |
| The example below will display the status of all devices |
| numbered 36Ø-37F that are online: |
| |
| DS P,36Ø,32,ON |
| |
| The example below will display the status of SMS |
| controlled device 37Ø and the three devices that follow |
| it: |
| |
| DS S,37Ø,4 |
| |
|******************************* BOTTOM OF DATA *******************************|