QUERY PARCELS

Issue the QUERY PARCELS command to obtain information about archived data. The command response lists parcel IDs, owning user, storage class, number of 4K data blocks, and the parcel expiration date.

Read syntax diagram — Figure 1. QUERY PARCELS command syntax

Skip visual syntax diagram — Figure 1. QUERY PARCELS command syntax

Authorization

Administrators can display information for all parcels in the archive.
General users can display information for parcels that they own.

Note: For those users with many parcels in the archive, the command response could potentially be verbose.

Operands

The QUERY PARCELS command has the following operand:

userid: The userid operand is available to administrators only. It limits the scope of parcels that are displayed to those owned by the specified user ID. You can specify an individual user ID or group of users by means of a wildcard expression. The wildcard expression is limited to the range of expressions that are supported by the CMS LISTFILE command. If not specified, userid defaults to an asterisk, which specifies all parcels to which the requesting user has access.

Example

Figure 2 shows an example of the QUERY PARCELS command.

Figure 2. QUERY PARCELS example

smsg amvarkiv query parcels                                                                       
Ready;                                                                                          
 *** Parcel 000000EC: Owner SAMPUSER, Storage class DEFAULT, 10 4K Blocks, Expires 6 Mar 2011.   
 *** Parcel 000000E0: Owner SAMPUSER, Storage class DEFAULT, 10 4K Blocks, Expires 24 Feb 2011.  
 *** Parcel 000000E1: Owner SAMPUSER, Storage class DEFAULT, 10 4K Blocks, Expires 24 Feb 2011.  
 *** Parcel 000000E2: Owner SAMPUSER, Storage class DEFAULT, 10 4K Blocks, Expires 24 Feb 2011.  
 *** Parcel 000000E3: Owner SAMPUSER, Storage class DEFAULT, 10 4K Blocks, Expires 2 Mar 2011.   
 *** Parcel 000000E4: Owner SAMPUSER, Storage class DEFAULT, 10 4K Blocks, Expires 2 Mar 2011.   
 *** Parcel 000000E5: Owner SAMPUSER, Storage class DEFAULT, 10 4K Blocks, Expires 2 Mar 2011.   
 *** Parcel 000000E6: Owner SAMPUSER, Storage class DEFAULT, 10 4K Blocks, Expires 2 Mar 2011.   
 *** Parcel 000000E7: Owner SAMPUSER, Storage class DEFAULT, 10 4K Blocks, Expires 2 Mar 2011.   
 *** Parcel 000000E8: Owner SAMPUSER, Storage class DEFAULT, 10 4K Blocks, Expires 3 Mar 2011.   
 *** Parcel 000000E9: Owner SAMPUSER, Storage class DEFAULT, 10 4K Blocks, Expires 3 Mar 2011.   
 *** Parcel 000000FF: Owner SAMPUSER, Storage class DEFAULT, 8 4K Blocks, Expires 7 Apr 2011.    
 *** Parcel 000000F6: Owner SAMPUSER, Storage class TAPE1, 261 4K Blocks, Expires 6 Apr 2011.    
 *** Parcel 000000F8: Owner SAMPUSER, Storage class TAPE1, 261 4K Blocks, Expires 6 Apr 2011.    
 *** Parcel 000000F9: Owner SAMPUSER, Storage class TAPE1, 263 4K Blocks, Expires 6 Apr 2011.    
 *** Parcel 00000100: Owner SAMPUSER, Storage class DEFAULT, 217 4K Blocks, Expires 7 Apr 2011.  
 *** Parcel 00000101: Owner SAMPUSER, Storage class DEFAULT, 217 4K Blocks, Expires 7 Apr 2011.  
 *** Parcel 00000102: Owner SAMPUSER, Storage class DEFAULT, 217 4K Blocks, Expires 7 Apr 2011.  
 *** Parcel 00000104: Owner SAMPUSER, Storage class SFSSIMPL, 217 4K Blocks, Expires 7 Apr 2011. 
 *** Parcel 0000011E: Owner SAMPUSER, Storage class TAPE1, 1805 4K Blocks, Expires 12 Aug 2011.  
 *** Parcel 0000011F: Owner SAMPUSER, Storage class TAPE1, 217 4K Blocks, Expires 12 Aug 2011.   
 *** Parcel 00000110: Owner SAMPUSER, Storage class DEFAULT, 8 4K Blocks, Expires 11 Aug 2011.   
 *** Parcel 00000111: Owner SAMPUSER, Storage class DEFAULT, 8 4K Blocks, Expires 11 Aug 2011.   
 *** Parcel 00000112: Owner SAMPUSER, Storage class DEFAULT, 8 4K Blocks, Expires 11 Aug 2011.   
 *** Parcel 00000113: Owner SAMPUSER, Storage class DEFAULT, 8 4K Blocks, Expires 11 Aug 2011.   
 *** Parcel 00000120: Owner SAMPUSER, Storage class SFSSIMPL, 26 4K Blocks, Expires 12 Aug 2011. 
 *** Parcel 00000121: Owner SAMPUSER, Storage class DEFAULT, 8 4K Blocks, Expires 13 Aug 2011.   
 *** Parcel 00000122: Owner SAMPUSER, Storage class CUSTOM, 8 4K Blocks, Expires 13 Aug 2011.    
 *** Parcel 00000123: Owner SAMPUSER, Storage class SFSSIMPL, 217 4K Blocks, Expires 13 Aug 2011.
 *** Parcel 00000124: Owner SAMPUSER, Storage class SFSDUPL, 217 4K Blocks, Expires 13 Aug 2011. 
 *** Parcel 00000125: Owner SAMPUSER, Storage class TAPE1, 3198 4K Blocks, Expires 13 Aug 2011.  
 *** Parcel 00000126: Owner SAMPUSER, Storage class DEFAULT, 8 4K Blocks, Expires 20 Aug 2011.   
 *** Parcel 00000127: Owner SAMPUSER, Storage class DEFAULT, 2 4K Blocks, Expires 20 Aug 2011.   
 *** Parcel 00000132: Owner SAMPUSER, Storage class TAPE2, 24 4K Blocks, Expires 26 Aug 2011.    
 Return code: 0