Displaying the RCDS status

Use the DISPLAY SMS,CICSVR,RCDS command to display the status of the RCDSs allocated to the CICS® VR server address space.

You can use this command to determine if any maintenance is required on the RCDSs. This figure shows an example of the output returned when the DISPLAY SMS,CICSVR,RCDS command is issued and all three RCDSs are properly allocated and in use by CICS® VR:

Figure 1. DISPLAY SMS,CICSVR,RCDS results when all three RCDSs are properly allocated and in use.


DWW520I DISPLAY SMS,CICSVR,RCDS               
                                              
DISPLAY SMS,CICSVR,RCDS - DATA SET NAMES      
  NAME      DATA SET NAME                     
  DWWCON1   DWW.DWWCON1.GRPPROD               
  DWWCON2   DWW.DWWCON2.GRPPROD               
  DWWCON3   DWW.DWWCON3.GRPPROD               
                                              
DISPLAY SMS,CICSVR,RCDS - STATUS              
  NAME      STATUS                            
  DWWCON1   IN USE                            
  DWWCON2   IN USE                            
  DWWCON3   IN USE                            
                                              
DISPLAY SMS,CICSVR,RCDS - SPACE               
  NAME      TOTAL   USED   UNIT               
  DWWCON1   2160K  1004K   200K               
  DWWCON2   2160K  1004K   200K      
  DWWCON3   1440K  1004K   200K

During some error conditions, CICS® VR automatically attempts to deallocate the RCDS. For example, if an RCDS becomes full, CICS® VR automatically attempts to deallocate the full RCDS from the CICS® VR server address space. Therefore, the status of the full RCDS might be shown as "OUT OF SET" after CICS® VR has deallocated the full RCDS. However, CICS® VR writes appropriate messages to the operator console when an RCDS error is encountered and when it is automatically deallocated. The status of each RCDS can be one of the following:

IN USE: An RCDS is currently allocated to the listed ddname and is accessible by the CICS® VR server address space. No further action is required.
OUT OF SET: The RCDS of the listed ddname is currently deallocated from the CICS® VR server address space. An RCDS can be deallocated from CICS® VR by issuing the VARY operator command or automatically by CICS® VR when it becomes full, unusable, or broken. An RCDS must be recreated and reallocated to the listed ddname as soon as possible.
INACCESSIBLE: The RCDS of the listed ddname is allocated to CICS® VR, but CICS® VR cannot access it to read and write information. Either make the RCDS accessible to CICS® VR, or deallocte it, then recreate and reallocate a new RCDS to the same ddname.
BROKEN: The RCDS for the listed ddname is corrupted. Deallocate the RCDS from CICS® VR, then recreate and redefine a new RCDS to the same ddname. CICS® VR automatically attempts to deallocate a broken RCDS.
FULL: The RCDS for the listed ddname has reached its capacity and no more information can be written to it. It must be deallocated from CICS® VR, then recreated with a larger capacity and reallocated to the same ddname. CICS® VR automatically attempts to deallocte a full RCDS.
INDELIBLE: The RCDS for the listed ddname could not be removed from CICS® VR. It must be manually deallocted from CICS® VR, then recreated and reallocated to the same ddname.
UNKNOWN: An unresolveable error has occurred while attempting to access the RCDS for the listed ddname. It must be deallocated from CICS® VR, then recreated and reallocated to the same ddname.