LISTUCB subcommand — list UCBs

Use the LISTUCB subcommand as a convenient means to request the display of one or more unit control blocks (UCBs).

Syntax

  { LISTUCB }   (device-number-list)
  { LISTU   }

-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.

              [ ACTIVE | MAIN | STORAGE          ]
              [ DSNAME(dsname) | DATASET(dsname) ]
              [ FILE(ddname) | DDNAME(ddname)    ]
              [ PATH(path-name)     ]
              [ DISPLAY[(display-options)]   ]
              [ NODISPLAY[(display-options)] ]
              [ FLAG(severity) ]
              [ PRINT | NOPRINT ]
              [ TERMINAL | NOTERMINAL ]
              [ TEST | NOTEST ]

Parameters
device-number-list
Specifies the device number for one or more devices for which UCBs are to be displayed. device-number-list can be:
- A single hexadecimal device number of up to 4 digits with a subchannel set identifier digit specified on qualified devices.
  - Parentheses are accepted but are not required.
  - Leading zero digits are accepted but are not required.
- A range of device numbers defined by the lowest and highest device numbers separated by a colon.
  - Parentheses are accepted but are not required.
  - Leading zeros are accepted but are not required.
  - The second device number must be as large as the first.
- A list containing either single device numbers or ranges of device numbers. Parentheses are required. In the list, separate list members with blanks, commas, or horizontal tabulation (X'05') characters. The separators are permitted, but not required, between the left parenthesis and the first member and between the last member and the right parenthesis.
IPCS processes the list from the left to the right, displaying UCBs in that order. IPCS displays UCBs in a range starting with the lowest device number. An individual UCB can be specified as often as you want and is displayed again each time it is specified.
Return Codes
See Standard subcommand return codes for a description of the return codes produced by the LISTUCB subcommand.

Example: Format the device for device 0410.

Action
```
COMMAND ===> LISTUCB 0410
```

Result

Figure 1. LISTUCB command report for device 0410

UCBPRFIX: 02103290                                                    
   -0008  LOCK..... 00000000  IOQ...... 02438400                      
UCBOB: 02103298                                                       
   +0000  JBNR..... 00        FL5...... 88        ID....... FF        
   +0003  STAT..... 84        CHAN..... 0410      FL1...... 00        
   +0007  FLB...... 00        NXUCB.... 00000000  WGT...... 08        
   +000D  NAME..... 410       TBYT1.... 30        TBYT2.... 30        
   +0012  DVCLS.... 20        UNTYP.... 0E        FLC...... 00        
   +0015  EXTP..... 103271    VTOC..... 00010100  VOLI..... BOZO40    
   +0022  STAB..... 10        DMCT..... 00        SQC...... 00        
   +0025  FL4...... A0        USER..... 0000      BASE..... 02103098  
   +002C  NEXP..... 02103558                                          
UCBCMXT: 02103270                                                     
   +0000  ETI...... 00        STI...... 00        FL6...... 09        
   +0003  ATI...... 40        SNSCT.... 20        FLP1..... 2A        
   +0006  STLI..... 00        FL7...... 08        IEXT..... 02129040  
   +000C  CHPRM.... 00        SATI..... 00        ASID..... 0000      
   +0010  RSV...... 00        WTOID.... 000000    DDT...... 00FCF228  
   +0018  CLEXT.... 02103230  DCTOF.... 0000      CSFLG.... 00 
   +001F  RSV...... 00                                               
UCBXPX: 02129040                                                     
   +0000  RSTEM.... 00        MIHKY.... 04        MIHTI.... 00       
   +0003  HOTIO.... 40        IOQF..... 00000000  IOQL..... 00000000 
                                                                     
          Subchannel-Identification:                                 
   +000C   CSS id                       00                           
   +000D   Iid/SSid                     01                           
   +000E   Number                       003A                         
                                                                     
   +0010  PMCW1.... 289C      MBI...... 006A      LPM...... F0       
   +0015  RSV...... 00        LPUM..... 80        PIM...... F0       
   +0018  CHPID.... 60708090  00000000            LEVEL.... 01       
   +0021  IOSF1.... 08        IOTKY.... 00        MIHFG.... 00       
   +0024  LVMSK.... 00000001                                         
                                                                     
Actual UCB Common segment address 02103298                           
Device is dynamic                                                    
Base UCB of a parallel access volume                   
Base UCB has bound alias UCB 00418 at address 02103758 
Base UCB has bound alias UCB 00419 at address 021037B8 
Base UCB has bound alias UCB 10410 at address 02120568 
Base UCB has bound alias UCB 10411 at address 021205C8 
Base UCB has bound alias UCB 10418 at address 02120868 
Base UCB has bound alias UCB 10419 at address 021208C8