QUERY RM command

Use the QUERY RM command to view status and attributes information about a Resource Manager (RM) address space. This command returns information about IMSRSC repositories managed by RM.

Subsections:

Environment

The QUERY RM command is processed by the Common Service Layer (CSL) Resource Manager (RM) address space.

Syntax

Read syntax diagramSkip visual syntax diagramQUERYQRYRMTYPE(REPO)SHOW(ALLATTRIBSTATUS)

Keywords

The following keywords are valid for the QUERY RM command:

TYPE
Specifies the type of data or information to be processed.
REPO
Specifies that information about all IMSRSC repositories defined to RM is to be returned.
SHOW
Specifies the information to be returned on the QUERY command.
ALL
Specifies that all the status and attribute information is to be returned.
ATTRIB
Specifies that the repository attributes in RM is to be returned. The attributes that are returned are AUDITACCESS settings in RM.
STATUS
Specifies that the status information in RM is to be returned. For possible status values that can be returned, see Output fields.

Usage notes

This command can be specified only through the Operations Manager (OM) API.

The QUERY RM command is defined to OM as ROUTE=ALL. The command is processed by each RM that receives the command.

The command syntax for this command is defined in XML and is available to automation programs that communicate with OM.

Output fields

The following table shows the QUERY RM output fields. The columns in the table are as follows:

Short label
Contains the short label generated in the XML output.
Long label
Contains the long label generated in the XML output.
Keyword
Identifies the keyword on the command that caused the field to be generated. N/A appears for output fields that are always returned.
Meaning
Provides a brief description of the output field.
Table 1. Output fields for QUERY RM command
Short label Long label Keyword Meaning
AUDACC AuditAccess ATTRIB, ALL AUDITACCESS attribute in RM.
CC CC N/A Completion code for the line of output. Completion code is always returned.
CCTXT CCText N/A Completion code text that briefly explains the meaning of the nonzero completion code.
MBR MbrName N/A Name of the RM that processes the command.
REPOGRP RepositoryGroup N/A z/OS® cross-system coupling facility (XCF) group that is associated to the Repository Server.
REPONM RepositoryName N/A Name of the repository that RM is connected to.
REPOTYP RepositoryType N/A Type of the repository that RM is connected to.
STT Status STATUS, ALL Status. Valid status values that can be returned are:
CONNECTED
Indicates that RM is connected to the IMSRSC repository and that the repository is available for use.
CONNECT-INCOMPLETE
Indicates that RM successfully connected to the repository, but RM either failed to correctly update the repository global entry in the resource structure or did not complete the initialization of the AFMT or IMBT in the IMSRSC repository. A CSL2518E error message is issued for any errors in initializing the AFMT or IMBT. In addition, other RM systems in the IMSplex might not have been notified with the directive to connect to the repository.

To complete the connect processing, the operator must issue the UPDATE RM TYPE(REPO) SET(REPO(Y)) command and route the command to the RM that has the CONNECT-INCOMPLETE status.

DISCONNECT-INCOMPLETE
Indicates that RM successfully disconnected from the repository, but RM failed to correctly update the repository global entry in the resource structure. In addition, other RM systems in the IMSplex might not have been notified to disconnect from the repository.

The operator must issue the UPDATE RM TYPE(REPO) SET(REPO(N)) command to complete the disconnect processing.

NOTAVAIL
Indicates that the repository is not available. RM reconnects to the repository when the Repository Server indicates to RM that the repository is available.
RS-NOTAVAIL
Indicates that there is no master Repository Server that is available. This status is displayed only when RM has successfully registered with the Repository Server, but the master Repository Server is down and there are no subordinate Repository Servers available to take over. The repository is not available for use until a Repository Server is available.
SPARERECOV
Indicates that the repository spare recovery process is in progress. The repository is not available during this process.
SPARERCVERR
Indicates that the repository spare recovery process resulted in an error and that the repository is not available for use. See the FRP messages issued by the Repository Server during the spare recovery process, and fix the error. The repository must be started after the error is fixed to make it available for use.
UPDATE-AUDACC-INCOMPLETE
Indicates that RM successfully updated the audit access setting in the repository, but RM failed to correctly update the repository global entry in the resource structure. In addition, other RM systems in the IMSplex might not have been notified to update the audit access value from the repository global entry.

The operator must issue the UPDATE RM TYPE(REPO) SET(REPO(AUDITACCESS)) command to complete the update of the audit access setting.

Return, reason, and completion codes

An IMS return and reason code is returned to OM by the QUERY RM command. The OM return and reason codes that might be returned as a result of the QUERY RM command are standard for all commands entered through the OM API.

The following table includes the return and reason codes and a brief explanation of the codes. The return or reason code returned for the command might also indicate an error from a CSL request.

Table 2. Return and reason codes for the QUERY RM command
Return code Reason code Meaning
X'00000000' X'00000000' The QUERY RM command completed successfully. The command output contains a line for each resource, accompanied by its completion code. See the completion code table for details.
X'03000008' X'0000203C' Invalid keyword parameter value.
X'0300000C' X'00003000' At least one request was successful.
X'0300000C' X'00003004' No requests were successful.
X'03000010' X'00004504' RM is not registered to the repository.
X'03000014' X'00005030' Command output response allocation failed.

The following table includes an explanation of the completion code.

Table 3. Completion code for the QUERY RM command
Completion code Meaning
0 The QUERY RM command completed successfully.

Examples

The following are examples of the QUERY RM command:

Example 1 for QUERY RM command

TSO SPOC input: 
QUERY RM TYPE(REPO) SHOW(ALL)
TSO SPOC output: 
(Screen 1)
RepositoryType MbrName    CC Status    AuditAccess 
IMSRSC         RM1RM       0 CONNECTED DEFAULT     
IMSRSC         RM2RM       0 CONNECTED DEFAULT       
IMSRSC         RM3RM       0 CONNECTED DEFAULT       	

(scrolled right to screen 2)
RepositoryType MbrName  RepositoryName               
IMSRSC         RM1RM    IMSRSC_REPOSITORY        
IMSRSC         RM2RM    IMSRSC_REPOSITORY         
IMSRSC         RM3RM    IMSRSC_REPOSITORY         

(scrolled right to screen 3) 
RepositoryType MbrName  RepositoryGroup     
IMSRSC         RM1RM    FRPGRUP1            
IMSRSC         RM2RM    FRPGRUP1            
IMSRSC         RM3RM    FRPGRUP1
OM API input: 
CMD(QUERY RM TYPE(REPO) SHOW(ALL))
OM API output: 
<imsout>                                        
<ctl>                                           
<omname>OM1OM   </omname>                       
<omvsn>1.5.0</omvsn>                            
<xmlvsn>20  </xmlvsn>                           
<statime>2011.186 22:43:56.527517</statime>     
<stotime>2011.186 22:43:56.540575</stotime>     
<staseq>C806A80CFEF9D40C</staseq>                                        
<stoseq>C806A80D0229FDC8</stoseq>                                        
<rqsttkn1>USRT005 10154356</rqsttkn1>                                    
<rc>00000000</rc>                                                        
<rsn>00000000</rsn>                                                      
</ctl>                                                                   
<cmd>                                                                    
<master>RM3RM   </master>                                                
<userid>USRT005 </userid>                                                
<verb>QRY </verb>                                                        
<kwd>RM              </kwd>                                              
<input>QUERY RM TYPE(REPO) SHOW(ALL) </input>                            
</cmd>                                                                   
<cmdrsphdr>                                                              
<hdr slbl="REPOTYP" llbl="RepositoryType" scope="LCL" sort="a" key="1"   
 scroll="no" len="8" dtype="CHAR" align="left" skipb="no" />             
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="2" scroll="no"  
 len="8" dtype="CHAR" align="left" skipb="no" />                         
<hdr slbl="CC" llbl="CC" scope="LCL" sort="n" key="0" scroll="yes"       
 len="4" dtype="INT" align="right" skipb="no" />                         
<hdr slbl="CCTXT" llbl="CCText" scope="LCL" sort="n" key="0"             
 scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />           
<hdr slbl="STT" llbl="Status" scope="LCL" sort="n" key="0" scroll="yes"  
len="*" dtype="CHAR" align="left" skipb="no" />                             
<hdr slbl="AUDACC" llbl="AuditAccess" scope="LCL" sort="n" key="0"           
 scroll="yes" len="*" dtype="CHAR" align="left" skipb="no" />                
<hdr slbl="REPONM" llbl="RepositoryName" scope="LCL" sort="n" key="0"        
 scroll="yes" len="44" dtype="CHAR" align="left" skipb="no" />               
<hdr slbl="REPOGRP" llbl="RepositoryGroup" scope="LCL" sort="n" key="0"      
 scroll="yes" len="8" dtype="CHAR" align="left" skipb="no" />                
</cmdrsphdr>                                                                 
<cmdrspdata>                                                                 
<rsp>REPOTYP(IMSRSC  ) MBR(RM3RM) CC(   0) REPONM(IMSRSC_REPOSITORY          
                       ) REPOGRP(FRPGRUP1) STT(CONNECTED)                    
 AUDACC(DEFAULT   ) </rsp>                                                   
<rsp>REPOTYP(IMSRSC  ) MBR(RM2RM) CC(   0) REPONM(IMSRSC_REPOSITORY          
                       ) REPOGRP(FRPGRUP1) STT(CONNECTED)                    
 AUDACC(DEFAULT   ) </rsp>                                                   
<rsp>REPOTYP(IMSRSC  ) MBR(RM1RM) CC(   0) REPONM(IMSRSC_REPOSITORY          
                       ) REPOGRP(FRPGRUP1) STT(CONNECTED)                    
 AUDACC(DEFAULT   ) </rsp>                                                   
</cmdrspdata>                                                                
</imsout>

Explanation: The repository names, the attributes, and status information for all the repositories enabled at RM are returned by the QUERY RM TYPE(REPO) SHOW(ALL) command. In the example, the repository is enabled at all RMs in the IMSplex.

Example 2 for QUERY RM command

TSO SPOC input: 
QUERY RM TYPE(REPO) SHOW(ATTRIB)
TSO SPOC output: 
(Screen 1)
RepositoryType MbrName    CC AuditAccess RepositoryName>  
IMSRSC         RM1RM       0 UPDATE      IMSRSC_REPOSITORY  
IMSRSC         RM2RM       0 UPDATE      IMSRSC_REPOSITORY  
IMSRSC         RM3RM       0 UPDATE      IMSRSC_REPOSITORY  

(scrolled right to screen 2)
RepositoryType MbrName  ryName RepositoryGroup 
IMSRSC         RM1RM           FRPGRUP1        
IMSRSC         RM2RM           FRPGRUP1        
IMSRSC         RM3RM           FRPGRUP1
OM API input: 
CMD(QUERY RM TYPE(REPO) SHOW(ATRIB)
OM API output: 
<imsout>                                      
<ctl>                                         
<omname>OM1OM   </omname>                     
<omvsn>1.5.0</omvsn>                          
<xmlvsn>20  </xmlvsn>                         
<statime>2011.187 17:07:32.104787</statime>   
<stotime>2011.187 17:07:32.118744</stotime>   
<staseq>C8079EB917653708</staseq>                                            
<stoseq>C8079EB91ACD82D7</stoseq>                                            
<rqsttkn1>USRT005 10100732</rqsttkn1>                                        
<rc>00000000</rc>                                                            
<rsn>00000000</rsn>                                                          
</ctl>                                                                       
<cmd>                                                                        
<master>RM3RM   </master>                                                    
<userid>USRT005 </userid>                                                    
<verb>QRY </verb>                                                            
<kwd>RM              </kwd>                                                  
<input>QRY RM TYPE(REPO) SHOW(ATTRIB) </input>                               
</cmd>                                                                       
<cmdrsphdr>                                                                  
<hdr slbl="REPOTYP" llbl="RepositoryType" scope="LCL" sort="a" key="1"       
 scroll="no" len="8" dtype="CHAR" align="left" skipb="no" />                 
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="2" scroll="no"      
 len="8" dtype="CHAR" align="left" skipb="no" />                             
<hdr slbl="CC" llbl="CC" scope="LCL" sort="n" key="0" scroll="yes"           
 len="4" dtype="INT" align="right" skipb="no" />                             
<hdr slbl="CCTXT" llbl="CCText" scope="LCL" sort="n" key="0"                 
 scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />               
<hdr slbl="AUDACC" llbl="AuditAccess" scope="LCL" sort="n" key="0"           
scroll="yes" len="*" dtype="CHAR" align="left" skipb="no" />                 
<hdr slbl="REPONM" llbl="RepositoryName" scope="LCL" sort="n" key="0"         
 scroll="yes" len="44" dtype="CHAR" align="left" skipb="no" />                
<hdr slbl="REPOGRP" llbl="RepositoryGroup" scope="LCL" sort="n" key="0"       
 scroll="yes" len="8" dtype="CHAR" align="left" skipb="no" />                 
</cmdrsphdr>                                                                  
<cmdrspdata>                                                                  
<rsp>REPOTYP(IMSRSC  ) MBR(RM3RM) CC(   0) REPONM(IMSRSC_REPOSITORY           
                       ) REPOGRP(FRPGRUP1) AUDACC(UPDATE    ) </rsp>          
<rsp>REPOTYP(IMSRSC  ) MBR(RM2RM) CC(   0) REPONM(IMSRSC_REPOSITORY           
                       ) REPOGRP(FRPGRUP1) AUDACC(UPDATE    ) </rsp>          
<rsp>REPOTYP(IMSRSC  ) MBR(RM1RM) CC(   0) REPONM(IMSRSC_REPOSITORY           
                       ) REPOGRP(FRPGRUP1) AUDACC(UPDATE    ) </rsp>          
</cmdrspdata>                                                                 
</imsout>

Explanation: The QUERY RM SHOW(ATTRIB) information returns the attribute information in RM. This command was issued after the audit access value was changed to UPDATE.

Example 3 for QUERY RM command

TSO SPOC input: 
QUERY RM TYPE(REPO) SHOW(ALL)
TSO SPOC output: 
Log for . . : QRY RM TYPE(REPO) SHOW(ALL)                                
                                                                         
IMSplex . . . . . : PLEX1                                                
Routing . . . . . :                                                      
Start time. . . . : 2011.187 10:28:53.20                                 
Stop time . . . . : 2011.187 10:28:53.22                                 
Return code . . . : 0200000C                                             
Reason code . . . : 00003004                                             
Reason text . . . : No requests were successful.                         
Command master. . : RM3RM                                                
                                                                         
            Return     Reason                                            
MbrName     Code       Code       Reason text                            
--------    --------   --------   --------------                         
RM3RM       03000010   00004504   Repository is not defined to RM        
RM2RM       03000010   00004504   Repository is not defined to RM        
RM1RM       03000010   00004504   Repository is not defined to RM
OM API input: 
CMD(QUERY RM TYPE(REPO) SHOW(ALL))
OM API output: 
<imsout>                                       
<ctl>                                          
<omname>OM1OM   </omname>                      
<omvsn>1.5.0</omvsn>                           
<xmlvsn>20  </xmlvsn>                          
<statime>2011.187 17:28:53.214617</statime>    
<stotime>2011.187 17:28:53.225942</stotime>    
<staseq>C807A37EDA599405</staseq>                                    
<stoseq>C807A37EDD1D651E</stoseq>                                    
<rqsttkn1>USRT005 10102853</rqsttkn1>                                
<rc>0200000C</rc>                                                    
<rsn>00003004</rsn>                                                  
<rsnmsg>CSLN024I</rsnmsg>                                            
<rsntxt>No requests were successful.</rsntxt>                        
</ctl>                                                               
<cmderr>                                                             
<mbr name="RM3RM   ">                                                
<typ>RM      </typ>                                                  
<styp>MULTRM  </styp>                                                
<rc>03000010</rc>                                                    
<rsn>00004504</rsn>                                                  
<rsntxt>Repository is not defined to RM</rsntxt>                     
</mbr>                                                               
<mbr name="RM2RM   ">                                                
<typ>RM      </typ>                                                  
<styp>MULTRM  </styp>                                                
<rc>03000010</rc>                                                    
<rsn>00004504</rsn>                                                  
<rsntxt>Repository is not defined to RM</rsntxt>                     
</mbr>                                                               
<mbr name="RM1RM   ">                                               
<typ>RM      </typ>                                                 
<styp>MULTRM  </styp>                                               
<rc>03000010</rc>                                                   
<rsn>00004504</rsn>                                                 
<rsntxt>Repository is not defined to RM</rsntxt>                    
</mbr>                                                              
</cmderr>                                                           
<cmd>                                                               
<master>RM3RM   </master>                                           
<userid>USRT005 </userid>                                           
<verb>QRY </verb>                                                   
<kwd>RM              </kwd>                                         
<input>QRY RM TYPE(REPO) SHOW(ALL) </input>                         
</cmd>                                                              
</imsout>

Explanation: This example shows the QUERY RM SHOW(ALL) command output when RM is not enabled to use the repository.