QUERY RTC command
Use the QUERY RTC command to query Fast Path routing codes. A routing code can be used by the Fast Path Input Edit/Routing Exit Routine (DBFHAGU0) to route a transaction to a different application program within the same load balancing group.
Subsections
Environment
The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the commands and keywords.
| Command / Keywords | DB/DC | DBCTL | DCCTL |
|---|---|---|---|
| QUERY RTC | X | X | |
| NAME | X | X | |
| SHOW | X | X | |
| STATUS | X | X |
Syntax
Keywords
The following keywords are valid for the QUERY RTC command:
- NAME
- Specifies the 1-8 character name of the routing code. Wildcards can be specified in the name. The name is a repeatable parameter. The default is NAME(*), which returns all routing code resources.
- SHOW
- Specifies the routing code output fields to be returned. The routing
code is always returned, along with the name of the IMS that created the output and the completion
code. The filters that are supported with the SHOW keyword are:
- ALL
- Returns all information about the routing code itself. Other SHOW
keywords can be specified to return information about resources that
are related to the routing code.Restriction: The ExportNeeded column, which is returned when SHOW(EXPORTNEEDED) is specified, is not returned with SHOW(ALL).
- DEFN
- Specifies that the resource definitions are to be returned.
The routing code attributes that can be returned are: INQ, PGM, the repository create and update time stamps, and the IMS runtime create, update, import, and access time stamps.
If SHOW(DEFN) is specified without any other SHOW filters or with the IMSID filter, all the definitional attributes are returned. The runtime resource definitions from the IMS system are returned by each IMS that receives the command. The stored resource definitions in the IMSRSC repository are returned by the command master IMS if the command master IMS is enabled to use the repository.
The command master IMS returns a response line for each generic stored resource definition obtained from the repository. This response line displays the attributes of the generic resource definition. When SHOW(DEFN) is specified without the IMSID filter and all the IMS systems have the same attribute values defined, only the response line for the generic definition is returned. The IMS IDs of the IMS systems that have the stored resource definition defined are not returned. If an IMS system has a stored resource definition with one or more attribute values that differ from the generic stored resource definition, an additional response line is returned for each IMS that has different attribute values.
If SHOW(DEFN,LOCAL) is specified, the runtime resource definitions from the IMS system are returned by each IMS that received the command.
If SHOW(DEFN,GLOBAL) is specified, the stored resource definitions from the repository are returned by the command master IMS. SHOW(DEFN,GLOBAL) is valid only when the command master IMS is enabled to use the repository. If the command master IMS is not enabled to use the repository, SHOW(DEFN,GLOBAL) results in an error return and reason code.
If SHOW(DEFN) is specified with other parameters, only the requested definitional attributes are returned. For example, if SHOW(DEFN,TIMESTAMP) is specified, only the time stamps are returned.Restrictions:- SHOW(DEFN) cannot be specified with DEFNTYPE, MODEL, STATUS, REGION, or WORK.
- The LclStat, LModelName, LModelType, and LDefnType columns, which are returned on the QRY RTC SHOW(ALL) command, are not returned with SHOW(DEFN).
- The Repo and IMSid columns, which are returned with SHOW(DEFN), are not returned with SHOW(ALL).
- When querying route code information from the repository, the SHOW(DEFN) filter is not supported when used with the STATUS filter. The runtime filter of STATUS is not valid with SHOW(DEFN), SHOW(DEFN,GLOBAL), SHOW(DEFN,LOCAL), SHOW(DEFN,IMSID), SHOW(DEFN,IMSID,GLOBAL) or SHOW(DEFN,IMSID,LOCAL).
If SHOW(DEFN,IMSID) is specified, a response line is returned for the generic stored resource definition, and an additional response line is returned for each IMS that has the resource defined in the repository, regardless of whether their stored resource definitions are the same as the generic resource definition.
The repository information for SHOW(DEFN) or SHOW(DEFN,IMSID) is processed only by the command master IMS and is valid only when the command master IMS is enabled to use the repository.
- DEFNTYPE
- Definition type that the resource was defined with.
- EXPORTNEEDED
- Specifies that only the routing code resources that match the NAME parameter and have not been
exported to the IMSRSC repository
since they were created or last updated are to be returned on the QUERY command.
If the NAME keyword is omitted or NAME(*) is specified, only the names of the routing codes that need to be exported to the repository are returned.
If a specific name or a generic name that is not NAME(*) is specified on the NAME keyword, a response line is returned for each routing code name specified on the command. If the specified routing code does not need to be exported to the repository, an N is returned in the ExportNeeded column.
SHOW(EXPORTNEEDED) cannot be specified with any other SHOW parameters or other keywords and is valid only when IMS is enabled with the IMSRSC repository.
The QUERY RTC SHOW(EXPORTNEEDED) command is not valid on an XRF alternate system.
Tip: For resources and descriptors that have not been exported to the IMSRSC repository, you can issue the EXPORT DEFN TARGET(REPO) OPTION(CHANGESONLY) command to write the resource and descriptor definitions to the repository so that they are available for the next IMS cold start. - GLOBAL
- Specifies that the stored resource definitions from the repository are to be returned. If SHOW(GLOBAL,DEFN) is specified, the global resource definitions from the repository are returned by the command master IMS. SHOW(GLOBAL,DEFN) is valid only when the command master IMS is enabled to use the repository.
- IMSID
- Specifies that the IMS IDs of the IMS systems whose resource lists contain the specified resource name are to be
returned. SHOW(IMSID) is processed only by the command master IMS and is valid only when the command master IMS is
enabled to use the repository.
When SHOW(IMSID) is specified with the DEFN filter, a separate line is returned for each IMS that has the resource defined, along with the stored resource definitions.
When SHOW(IMSID) is specified without the DEFN filter, a separate line is returned for each IMS that has the resource defined, along with the resource name. No resource definitions are returned.
SHOW(IMSID) cannot be specified with any other SHOW filters other than DEFN and GLOBAL. If SHOW(IMSID,GLOBAL) is specified, GLOBAL is ignored; that is, SHOW(IMSID,GLOBAL) is treated as SHOW(IMSID). SHOW(DEFN,IMSID,LOCAL) is treated as SHOW(DEFN,LOCAL).
SHOW(IMSID) cannot be specified with the STATUS() filter.
- INQ
- Inquiry option for transaction messages associated with this routing code.
- LOCAL
- Specifies that the runtime resource definitions from the IMS system are to be returned.
SHOW(DEFN,LOCAL) returns only the local definitional attributes from the IMS system that processes the command.
- MODEL
- The model name and model type used to create this resource. If the resource is created with all of the attributes defined and no model specified, the model name and model type are blank. The CREATE command specified without the LIKE keyword creates a resource using the default descriptor as a model. The default descriptor is either the IMS descriptor DBFDSRT1 or user-defined. The CREATE command specified with the LIKE keyword creates a resource using a model. The resource is created with all the same attributes as the model. Attributes set explicitly by the CREATE command override the model attributes. The model type can either be a descriptor (DESC) or a resource (RSC). The model name and model type are for reference only. The resource attributes might not match the model, if attributes are overridden by CREATE or UPDATE command values, or the model is updated later. The model name and model type can be used to identify resources that were created with the same model. The model name and model type of a resource are exported and imported. The IMPORT command does not use the model name and model type when creating a resource.
- PGM
- Program associated with this routing code.
- REGION
- Regions where the routing code is active.Note: You cannot specify this filter with other SHOW filters; you must specify SHOW(REGION) individually.
- STATUS
- Local routing code status. For a description of the possible routing code status returned, see the STATUS keyword in the "Output fields for the QUERY RTC command" under Output fields.
- TIMESTAMP
- The creation time (TIMECREATE), last update time (TIMEUPDATE),
last access time (TIMEACCESS), and last import time (TIMECREATE) time
stamps are returned. The time is returned in local time in the format
YYYY.JJJ HH:MM:SS.TH, where:
- YYYY is the year.
- JJJ is the Julian day (001 - 365).
- HH is the hour (01 - 24).
- MM is the minute (00 - 59).
- SS is the seconds (00 - 59).
- TH is the tenths and hundredths of a second (00 - 99).
- WORK
-
Work in progress for the routing code specified on NAME parameter and its associated resources. The QRY RTC SHOW(WORK) command can be issued before a DELETE, IMPORT or UPDATE command to check for any work in progress for the specified routing code and any of its associated resources. Any work in progress might cause the subsequent DELETE, IMPORT or UPDATE commands to fail. The QRY RTC SHOW(WORK) command returns the resource name, resource type, and work status for the work in progress for the routing code specified on the NAME parameter or work in progress for an associated resource. If no work is in progress for the specified resource as response line is returned with a work status of blanks.
SHOW(WORK) specified with NAME(*) might take a long time.
Notes:- You cannot specify this filter with other SHOW filters; you must specify SHOW(WORK) individually.
- The QRY RTC SHOW(WORK) command is not valid on an XRF alternate.
- STATUS()
- Selects routing codes for display that match the NAME parameter
and possess at least one of the specified routing code status values.
- ACTIVE
- Sets the STATUS() filter to return information about active routing codes.
- NOTINIT
- Sets the STATUS() filter to return information about routing codes that are not initialized and cannot be used.
- NOTSCHD
- Sets the STATUS() filter to return information about routing codes that are not scheduled.
- STOQ
- Sets the STATUS() filter to return information about routing codes that are stopped. Transactions that are associated with this routing code are not processed.
Usage notes
This command can be issued only through the Operations Manager API. Fast Path must be installed on the system. This command applies to DB/DC and DCCTL systems.
This command is allowed on XRF alternate systems.
If you want to display information about resource definitions, specify SHOW(DEFN). If you want to know which IMS systems have the resource defined and also know the attributes or resource definitions at each IMS system, specify SHOW(DEFN,IMSID). If you want to know which IMS systems have the resource defined, specify SHOW(IMSID).
Output fields
- Short label
- Contains the short label generated in the XML output.
- Long label
- Contains the long label generated in the XML output.
- Keyword
- Identifies keyword on the command that caused the field to be generated. N/A appears for output fields that are always returned. error appears for output fields that are returned only in case of an error.
- Scope
- Identifies the scope of the output field.
- Meaning
- Provides a brief description of the output field.
| Short label | Long label | Keyword | Scope | Meaning |
|---|---|---|---|---|
| CC | CC | N/A | LCL | Completion code. |
| CCTXT | CCText | error | LCL | Completion code text that briefly explains the meaning of the non-zero completion code. |
| DFNT | LDefnType | DEFNTYPE | LCL | Definition type, which can be one of the following:
|
| EXPN | ExportNeeded | EXPORTNEEDED | LCL | Indicates whether the routing code has been exported to the IMSRSC repository. The value can be Y or N. |
| IMSID | IMSid | IMSID | GBL | Returns the IMSIDs that have resource defined from the repository. |
| INQ | LInq | INQ, DEFN | LCL | Inquiry transaction associated with routing code
(Y) or not (N). The value is obtained from the local IMS.
|
| LSTT | LcLStat | STATUS | LCL | Local routing code status.
|
| MBR | MbrName | N/A | LCL | IMSplex member that built the output line. |
| MDLN | LModelName | MODEL | LCL | Model name. Name of the resource used as a model to create this resource. DBFDSRT1 is the IMS descriptor name for routing codes. |
| MDLT | LModelType | MODEL | LCL | Model type, either RSC or DESC. RSC means that the resource was created using another resource as a model. DESC means that the resource was created using a descriptor as a model. |
| PGM | PgmName | PGM | LCL | Program name. |
| REG | Region | REGION | LCL | Region where the routing code is active. |
| REPO | Repo | DEFN | GBL | Indicates whether the output line contains the
stored resource definitions.
|
| RINQ | Inq | INQ, DEFN | GBL | Inquiry transaction associated with routing code (Y) or not (N). The value is obtained from the repository. |
| RPGM | PgmName | DEFN | GBL | Program name. The value is obtained from the repository. |
| RTC | Rtcode | RTC | LCL | Routing code name. |
| RTMCR | TimeCreate | DEFN | GBL | Create time from the repository. This is the time the resource was first created in the repository. |
| RTMUP | TimeUpdate | DEFN | GBL | Update time from the repository. This is the time the resource was last updated in the repository. |
| TMAC | LTimeAccess | TIMESTAMP | LCL | The time that the resource was last accessed. The last access time is retained across warm start, emergency restart, EXPORT and IMPORT. The updating of the last access time is not logged. After a restart, the last access time reflects the time recorded in the restart checkpoint log records. The value is returned from the local IMS. For a routing code resource, the following actions update the last access time:
|
| TMCR | LTimeCreate | TIMESTAMP | LCL | The time that the routing code was created. This is the result of a CREATE RTC command, IMPORT command that creates the routing code, or IMS initialization. The create time is retained across warm start, emergency restart, EXPORT and IMPORT. The value is returned from the local IMS. |
| TMIM | LTimeImport | TIMESTAMP | LCL | The time that the resource was last imported, if applicable. The import time is retained across warm start and emergency restart. The value is returned from the local IMS. |
| TMUP | LTimeUpdate | TIMESTAMP | LCL | The last time the attributes of the runtime resource definition were updated as a result of the UPDATE RTC command or the IMPORT command. The update time is retained across warm start and emergency restart. The output value is obtained from the local IMS. |
| WRK | Work | WORK | LCL | Work is in progress for the routing code or one of its associated resources. The work in progress can be one of the following:
|
| Reason | Meaning |
|---|---|
| NOPGM | The program that this routing code references is not defined. No program PDIR control block exists. Action: 2. |
| REPOCHGLIST | The routing code name exists in the change list in the IMSRSC repository for this IMS, and the change list is being processed or the change list processing failed because of an error. This routing code cannot be used, scheduled, updated, exported, or referenced as a model until it is successfully imported so that the runtime routing code definition and the stored definition in the repository are synchronized. Action: 3. |
|
Note: Actions that can be taken to initialize the routing code are:
|
|
Return, reason, and completion codes
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.
| Return code | Reason code | Meaning |
|---|---|---|
| X'00000000' | X'00000000' | 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'00000004' | X'00001010' | No resources were found to be returned. The resource
names specified might be invalid, or:
|
| X'00000008' | X'00002004' | Invalid command keyword or invalid command keyword combination. |
| X'0000000C' | X'00003000' | Command was successful for some resources but failed for others. The command output contains a line for each resource, accompanied by its completion code. See the completion code table for details. |
| X'0000000C' | X'00003004' | Command was not successful for any of the resources. The command output contains a line for each resource, accompanied by its completion code. See the completion code table for details. |
| X'00000010' | X'00004004' | No CQS address space. |
| X'00000010' | X'00004018' | No resource structure, or resource structure is not available. |
| X'00000010' | X'00004024' | No Fast Path defined. |
| X'00000010' | X'00004100' | Resource structure is full. |
| X'00000010' | X'00004104' | No RM address space. |
| X'00000010' | X'00004108' | No SCI address space. |
| X'00000010' | X'00004300' | Command is not allowed because online change for MODBLKS is enabled (DFSDFxxx or DFSCGxxx defined with MODBLKS OLC, or MODBLKS not defined). |
| X'00000010' | X'00004500' | IMS is not enabled to use the repository. |
| X'00000010' | X'00004501' | RM is not enabled with the repository. |
| X'00000010' | X'00004502' | Repository is not available. |
| X'00000010' | X'00004503' | Repository is stopped. |
| X'00000010' | X'00004504' | Repository spare recovery is in progress. |
| X'00000010' | X'00004505' | No IMS resource list exists, or no resources for the resource type exist in the IMS resource list. |
| X'00000010' | X'00004507' | Repository access is denied. |
| X'00000010' | X'00004508' | Repository maximum put length exceeded. |
| X'00000010' | X'00004509' | RM data version is lower than the IMS data version. |
| X'00000010' | X'0000450A' | Repository Server is being shut down. |
| X'00000010' | X'0000450B' | Repository Server is not available. |
| X'00000010' | X'0000450C' | Repository Server is busy. |
| X'00000010' | X'0000450D' | RM failed to define some of the internal fields related to the IMSRSC repository. |
| X'00000014' | X'00005004' | DFSOCMD response buffer could not be obtained. |
| X'00000014' | X'0000501C' | IMODULE GETMAIN error. |
| X'00000014' | X'00005100' | RM request error. |
| X'00000014' | X'00005104' | CQS error. |
| X'00000014' | X'00005108' | SCI request error. |
| X'00000014' | X'00005110' | Repository error. |
| X'00000014' | X'0000551C' | A request to view the data in the repository was rejected because a corrupted resource list was detected. The QUERY RTC command is rejected because the resource list is unusable. Contact IBM Software Support. Send in the output from the command in error, and a dump of the local RM address space where the command executed or the dump of all RM address spaces in the IMSplex. Also send a copy of the IMSRSC repository RID and RMD data sets. |
Errors unique to the processing of this command are returned as completion codes. The following table includes an explanation of the completion codes.
| Completion code | Completion code text | Meaning |
|---|---|---|
| 0 | Command completed successfully for routing code. | |
| 10 | NO RESOURCES FOUND | Routing code name is invalid, or the wildcard parameter specified does not match any resource names. |
Examples
The following are examples of the QUERY RTC command:
Example 1 for QUERY RTC command
QUERY RTC NAME(%%%%,TXCDJN11,TXBANKI2,RTC0*) SHOW(ALL)(screen 1)
Rtcode MbrName CC LPgmName LInq LclStat LModelName LModelType
GFP1 IMS1 0 DCGPSBFP N NOTSCHD
GFP2 IMS1 0 DCGPSBF2 N NOTSCHD
RTC00001 IMS1 0 DCGPSBF2 N NOTSCHD GFP2 RSC
TXBANKI2 IMS1 0 BANKIFP N NOTSCHD
TXCDJN11 IMS1 0 DDLTJN11 Y NOTSCHD
(scrolled to the right screen 2)
Rtcode MbrName CC LTimeCreate LTimeUpdate
GFP1 IMS1 0 2011.180 12:37:38.07
GFP2 IMS1 0 2011.180 12:37:38.07
RTC00001 IMS1 0 2011.180 12:40:05.33
TXBANKI2 IMS1 0 2011.180 12:37:38.07
TXCDJN11 IMS1 0 2011.180 12:37:38.07
(scrolled to the right screen 3)
Rtcode MbrName CC LTimeAccess LTimeImport LDefnType
GFP1 IMS1 0 MODBLKS
GFP2 IMS1 0 2011.180 13:18:54.79 MODBLKS
RTC00001 IMS1 0 CREATE
TXBANKI2 IMS1 0 MODBLKS
TXCDJN11 IMS1 0 MODBLKS CMD(QUERY RTC NAME(%%%%,TXCDJN11,TXBANKI2,RTC0*) SHOW(ALL))<imsout>
<ctl>
<omname>OM1OM </omname>
<omvsn>1.5.0</omvsn>
<xmlvsn>20 </xmlvsn>
<statime>2011.180 21:00:03.888063</statime>
<stotime>2011.180 21:00:03.888992</stotime>
<staseq>C7FF05A4527BF4CA</staseq>
<stoseq>C7FF05A452B602CA</stoseq>
<rqsttkn1>USRT005 10140003</rqsttkn1>
<rc>00000000</rc>
<rsn>00000000</rsn>
</ctl>
<cmd>
<master>IMS1 </master>
<userid>USRT005 </userid>
<verb>QRY </verb>
<kwd>RTC </kwd>
<input>QUERY RTC NAME(%%%%,TXCDJN11,TXBANKI2,RTC0*) SHOW(ALL) </input>
</cmd>
<cmdrsphdr>
<hdr slbl="RTC" llbl="Rtcode" scope="LCL" sort="a" key="1" scroll="no"
len="8" dtype="CHAR" align="left" />
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="4" scroll="no"
len="8" dtype="CHAR" align="left" />
<hdr slbl="CC" llbl="CC" scope="LCL" sort="n" key="0" scroll="no"
len="4" dtype="CHAR" align="right" />
<hdr slbl="CCTXT" llbl="CCText" scope="LCL" sort="n" key="0"
scroll="yes" len="*" dtype="CHAR" skipb="yes" align="left" />
<hdr slbl="PGM" llbl="LPgmName" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" />
<hdr slbl="INQ" llbl="LInq" scope="LCL" sort="n" key="0" scroll="yes"
len="1" dtype="INT" align="left" />
<hdr slbl="LSTT" llbl="LclStat" scope="LCL" sort="n" key="0"
scroll="yes" len="*" dtype="CHAR" align="left" />
<hdr slbl="MDLN" llbl="LModelName" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" />
<hdr slbl="MDLT" llbl="LModelType" scope="LCL" sort="n" key="0"
scroll="yes" len="4" dtype="CHAR" align="left" />
<hdr slbl="TMCR" llbl="LTimeCreate" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" />
<hdr slbl="TMUP" llbl="LTimeUpdate" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" />
<hdr slbl="TMAC" llbl="LTimeAccess" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" />
<hdr slbl="TMIM" llbl="LTimeImport" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" />
<hdr slbl="DFNT" llbl="LDefnType" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" />
</cmdrsphdr>
<cmdrspdata>
<rsp>RTC(GFP1 ) MBR(IMS1 ) CC( 0) PGM(DCGPSBFP) INQ(N)
LSTT(NOTSCHD) TMCR(2011.180 12:37:38.07) TMUP( )
TMAC( ) TMIM( ) DFNT(MODBLKS )
</rsp>
<rsp>RTC(GFP2 ) MBR(IMS1 ) CC( 0) PGM(DCGPSBF2) INQ(N)
LSTT(NOTSCHD) TMCR(2011.180 12:37:38.07) TMUP( )
TMAC(2011.180 13:18:54.79) TMIM( ) DFNT(MODBLKS )
</rsp>
<rsp>RTC(TXCDJN11) MBR(IMS1 ) CC( 0) PGM(DDLTJN11) INQ(Y)
LSTT(NOTSCHD) TMCR(2011.180 12:37:38.07) TMUP( )
TMAC( ) TMIM( ) DFNT(MODBLKS )
</rsp>
<rsp>RTC(TXBANKI2) MBR(IMS1 ) CC( 0) PGM(BANKIFP ) INQ(N)
LSTT(NOTSCHD) TMCR(2011.180 12:37:38.07) TMUP( )
TMAC( ) TMIM( ) DFNT(MODBLKS )
</rsp>
<rsp>RTC(RTC00001) MBR(IMS1 ) CC( 0) PGM(DCGPSBF2) INQ(N)
LSTT(NOTSCHD) MDLN(GFP2 ) MDLT(RSC) TMCR(2011.180 12:40:05.33)
TMUP( ) TMAC( ) TMIM(
) DFNT(CREATE )</rsp>
</cmdrspdata>
</imsout> Explanation: The QUERY RTC command is specified with SHOW(ALL), so all output fields are returned for the specified routing codes. All of the routing code output fields do not fit on one screen, so the user must scroll to the right for additional output fields. The routing code name, the member name that built the line of output, and the completion code are displayed on every screen. Routing code wildcard parameter %%%% causes all routing codes with 4-character names to be displayed. The routing codes that were generated in stage 1 MODBLKS generation are created when IMS cold starts and defined with a definition type of MODBLKS. Routing codes RTC00001 and RTC00002 were created dynamically using CREATE RTC commands and display a definition type of CREATE. RTC00001 was created using routing code GFP2 as the model and RTC00002 was created using default descriptor DBFDSRT1. Routing code GFP2 displays the last access time stamp, from when it was referred to by the CREATE RTC command that created routing code RTC00001, using routing code GFP2 as the model. Routing code RTC00002 shows the last update time, because its program was changed by an UPDATE RTC command since it was created.
Example 2 for QUERY RTC command
QUERY RTC NAME(RTC00001) SHOW(DEFN,PGM,INQ)Rtcode MbrName CC Repo IMSid PgmName LPgmName Inq LInq
RTC00001 IMS1 0 Y DCGPSBF2 N
RTC00001 IMS1 0 IMS1 DCGPSBF2 N
RTC00001 IMS2 0 IMS2 DCGPSBF2 N
RTC00001 IMS3 0 IMS3 DCGPSBF2 N CMD(QUERY RTC NAME(RTC00001) SHOW(DEFN,PGM,INQ))<imsout>
<ctl>
<omname>OM1OM </omname>
<omvsn>1.5.0</omvsn>
<xmlvsn>20 </xmlvsn>
<statime>2011.180 20:50:14.242034</statime>
<stotime>2011.180 20:50:14.300210</stotime>
<staseq>C7FF0371FDEF225C</staseq>
<stoseq>C7FF03720C232D8C</stoseq>
<rqsttkn1>USRT005 10135014</rqsttkn1>
<rc>00000000</rc>
<rsn>00000000</rsn>
</ctl>
<cmd>
<master>IMS1 </master>
<userid>USRT005 </userid>
<verb>QRY </verb>
<kwd>RTC </kwd>
<input>QUERY RTC NAME(RTC00001) SHOW(DEFN,PGM,INQ) </input>
</cmd>
<cmdrsphdr>
<hdr slbl="RTC" llbl="Rtcode" scope="LCL" sort="a" key="1" scroll="no"
len="8" dtype="CHAR" align="left" />
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="4" scroll="no"
len="8" dtype="CHAR" align="left" />
<hdr slbl="CC" llbl="CC" scope="LCL" sort="n" key="0" scroll="no"
len="4" dtype="CHAR" align="right" />
<hdr slbl="CCTXT" llbl="CCText" scope="LCL" sort="n" key="0"
scroll="yes" len="*" dtype="CHAR" skipb="yes" align="left" />
<hdr slbl="REPO" llbl="Repo" scope="LCL" sort="d" key="2" scroll="no"
len="1" dtype="CHAR" align="left" />
<hdr slbl="IMSID" llbl="IMSid" scope="GBL" sort="n" key="0"
scroll="yes" len="4" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RPGM" llbl="PgmName" scope="GBL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" />
<hdr slbl="PGM" llbl="LPgmName" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" />
<hdr slbl="RINQ" llbl="Inq" scope="GBL" sort="n" key="0" scroll="yes"
len="1" dtype="INT" align="left" />
<hdr slbl="INQ" llbl="LInq" scope="LCL" sort="n" key="0" scroll="yes"
len="1" dtype="INT" align="left" />
</cmdrsphdr>
<cmdrspdata>
<rsp>RTC(RTC00001) MBR(IMS3 ) CC( 0) PGM(DCGPSBF2) INQ(N)
IMSID(IMS3)</rsp>
<rsp>RTC(RTC00001) MBR(IMS1 ) CC( 0) REPO(Y) RINQ(N)
RPGM(DCGPSBF2) </rsp>
<rsp>RTC(RTC00001) MBR(IMS1 ) CC( 0) PGM(DCGPSBF2) INQ(N)
IMSID(IMS1)</rsp>
<rsp>RTC(RTC00001) MBR(IMS2 ) CC( 0) PGM(DCGPSBF2) INQ(N)
IMSID(IMS2)</rsp>
</cmdrspdata>
</imsout> Explanation: The stored resource definitions and the runtime resource definitions for the specified resources are returned. Only the program name and the INQ information are returned because the SHOW(PGM,INQ) option is specified.
Example 3 for QUERY RTC command
QUERY RTC NAME(E*) SHOW(DEFN)(screen 1)
Rtcode MbrName CC Repo IMSid PgmName LPgmName Inq LInq TimeCreate>
EMHTX2 IMS1 0 Y EMHPSB2 N 2011.180 12:37:33.37
EMHTX2 IMS1 0 IMS1 EMHPSB2 N
EMHTX2 IMS2 0 IMS2 EMHPSB2 N
EMHTX22 IMS1 0 Y EMHPSB2 N 2011.180 12:37:33.37
EMHTX22 IMS1 0 IMS1 EMHPSB2 N
EMHTX22 IMS2 0 IMS2 EMHPSB2 N
EMHTX3 IMS1 0 Y EMHPSB2 N 2011.180 12:37:33.37
EMHTX3 IMS1 0 IMS1 EMHPSB2 N
EMHTX3 IMS2 0 IMS2 EMHPSB2 N
EMHTX32 IMS1 0 Y EMHPSB2 N 2011.180 12:37:33.37
EMHTX32 IMS1 0 IMS1 EMHPSB2 N
EMHTX32 IMS2 0 IMS2 EMHPSB2 N
(scrolled right to screen 2)
Rtcode MbrName CC Repo LTimeCreate TimeUpdate LTimeUpdate
EMHTX2 IMS1 0 Y
EMHTX2 IMS1 0 2011.180 12:37:38.07
EMHTX2 IMS2 0 2011.180 12:37:38.08
EMHTX22 IMS1 0 Y
EMHTX22 IMS1 0 2011.180 12:37:38.07
EMHTX22 IMS2 0 2011.180 12:37:38.08
EMHTX3 IMS1 0 Y
EMHTX3 IMS1 0 2011.180 12:37:38.07
EMHTX3 IMS2 0 2011.180 12:37:38.08
EMHTX32 IMS1 0 Y
EMHTX32 IMS1 0 2011.180 12:37:38.07
EMHTX32 IMS2 0 2011.180 12:37:38.08
(scrolled right to screen 3)
Rtcode MbrName CC Repo LTimeAccess LTimeImport
EMHTX2 IMS1 0 Y
EMHTX2 IMS1 0
EMHTX2 IMS2 0
EMHTX22 IMS1 0 Y
EMHTX22 IMS1 0
EMHTX22 IMS2 0
EMHTX3 IMS1 0 Y
EMHTX3 IMS1 0
EMHTX3 IMS2 0
EMHTX32 IMS1 0 Y
EMHTX32 IMS1 0
EMHTX32 IMS2 0 CMD(QUERY RTC NAME(E*) SHOW(DEFN))<imsout>
<ctl>
<omname>OM1OM </omname>
<omvsn>1.5.0</omvsn>
<xmlvsn>20 </xmlvsn>
<statime>2011.180 21:11:32.267556</statime>
<stotime>2011.180 21:11:32.351185</stotime>
<staseq>C7FF0834CFE246DE</staseq>
<stoseq>C7FF0834E44D1F9A</stoseq>
<rqsttkn1>USRT005 10141132</rqsttkn1>
<rc>00000000</rc>
<rsn>00000000</rsn>
</ctl>
<cmd>
<master>IMS1 </master>
<userid>USRT005 </userid>
<verb>QRY </verb>
<kwd>RTC </kwd>
<input>QUERY RTC NAME(E*) SHOW(DEFN) </input>
</cmd>
<cmdrsphdr>
<hdr slbl="RTC" llbl="Rtcode" scope="LCL" sort="a" key="1" scroll="no"
len="8" dtype="CHAR" align="left" />
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="4" scroll="no"
len="8" dtype="CHAR" align="left" />
<hdr slbl="CC" llbl="CC" scope="LCL" sort="n" key="0" scroll="no"
len="4" dtype="CHAR" align="right" />
<hdr slbl="CCTXT" llbl="CCText" scope="LCL" sort="n" key="0"
scroll="yes" len="*" dtype="CHAR" skipb="yes" align="left" />
<hdr slbl="REPO" llbl="Repo" scope="LCL" sort="d" key="2" scroll="no"
len="1" dtype="CHAR" align="left" />
<hdr slbl="IMSID" llbl="IMSid" scope="GBL" sort="n" key="0"
scroll="yes" len="4" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RPGM" llbl="PgmName" scope="GBL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" />
<hdr slbl="PGM" llbl="LPgmName" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" />
<hdr slbl="RINQ" llbl="Inq" scope="GBL" sort="n" key="0" scroll="yes"
len="1" dtype="INT" align="left" />
<hdr slbl="INQ" llbl="LInq" scope="LCL" sort="n" key="0" scroll="yes"
len="1" dtype="INT" align="left" />
<hdr slbl="RTMCR" llbl="TimeCreate" scope="GBL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" />
<hdr slbl="TMCR" llbl="LTimeCreate" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" />
<hdr slbl="RTMUP" llbl="TimeUpdate" scope="GBL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" />
<hdr slbl="TMUP" llbl="LTimeUpdate" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" />
<hdr slbl="TMAC" llbl="LTimeAccess" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" />
<hdr slbl="TMIM" llbl="LTimeImport" scope="LCL" sort="n" key="0"
scroll="yes" len="20" dtype="CHAR" align="left" />
</cmdrsphdr>
<cmdrspdata>
<rsp>RTC(EMHTX2 ) MBR(IMS1 ) CC( 0) PGM(EMHPSB2 ) INQ(N)
IMSID(IMS1) TMCR(2011.180 12:37:38.07) TMUP( )
TMAC( ) TMIM( )</rsp>
<rsp>RTC(EMHTX22 ) MBR(IMS1 ) CC( 0) PGM(EMHPSB2 ) INQ(N)
IMSID(IMS1) TMCR(2011.180 12:37:38.07) TMUP( )
TMAC( ) TMIM( )</rsp>
<rsp>RTC(EMHTX3 ) MBR(IMS1 ) CC( 0) PGM(EMHPSB2 ) INQ(N)
IMSID(IMS1) TMCR(2011.180 12:37:38.07) TMUP( )
TMAC( ) TMIM( )</rsp>
<rsp>RTC(EMHTX32 ) MBR(IMS1 ) CC( 0) PGM(EMHPSB2 ) INQ(N)
IMSID(IMS1) TMCR(2011.180 12:37:38.07) TMUP( )
TMAC( ) TMIM( )</rsp>
<rsp>RTC(EMHTX2 ) MBR(IMS1 ) CC( 0) REPO(Y) RINQ(N) RPGM(EMHPSB2
) RTMCR(2011.180 12:37:33.37) </rsp>
<rsp>RTC(EMHTX22 ) MBR(IMS1 ) CC( 0) REPO(Y) RINQ(N) RPGM(EMHPSB2
) RTMCR(2011.180 12:37:33.37) </rsp>
<rsp>RTC(EMHTX3 ) MBR(IMS1 ) CC( 0) REPO(Y) RINQ(N) RPGM(EMHPSB2
) RTMCR(2011.180 12:37:33.37) </rsp>
<rsp>RTC(EMHTX32 ) MBR(IMS1 ) CC( 0) REPO(Y) RINQ(N) RPGM(EMHPSB2
) RTMCR(2011.180 12:37:33.37) </rsp>
<rsp>RTC(EMHTX2 ) MBR(IMS2 ) CC( 0) PGM(EMHPSB2 ) INQ(N)
IMSID(IMS2) TMCR(2011.180 12:37:38.08) TMUP( )
TMAC( ) TMIM( )</rsp>
<rsp>RTC(EMHTX22 ) MBR(IMS2 ) CC( 0) PGM(EMHPSB2 ) INQ(N)
IMSID(IMS2) TMCR(2011.180 12:37:38.08) TMUP( )
TMAC( ) TMIM( )</rsp>
<rsp>RTC(EMHTX3 ) MBR(IMS2 ) CC( 0) PGM(EMHPSB2 ) INQ(N)
IMSID(IMS2) TMCR(2011.180 12:37:38.08) TMUP( )
TMAC( ) TMIM( )</rsp>
<rsp>RTC(EMHTX32 ) MBR(IMS2 ) CC( 0) PGM(EMHPSB2 ) INQ(N)
IMSID(IMS2) TMCR(2011.180 12:37:38.08) TMUP( )
TMAC( ) TMIM( )</rsp>
</cmdrspdata>
</imsout> Explanation: A line is returned for each resource that matches the wildcard name. The resource definitions from each IMS that has the resource defined and the global repository definition are returned. The repository information is returned by the command master IMS. There are no IMS-specific sections in the repository for each resource name that matches the wildcard name.
Example 4 for QUERY RTC command
QUERY RTC NAME(RTC00001) SHOW(EXPORTNEEDED)Rtcode MbrName CC ExportNeeded
RTC00001 IMS1 0 N CMD(QUERY RTC SHOW(EXPORTNEEDED))