QUERY IMSCON TYPE(CONFIG) command
Use the QUERY IMSCON TYPE(CONFIG) command to display the status and activity of IMS Connect. Unlike the similar WTOR command VIEWHWS or the z/OS® command QUERY MEMBER TYPE(IMSCON), individual resources such as PORT and DATASTORE are not displayed with this command.
Subsections:
Environment
The QUERY IMSCON command
is applicable only to IMS Connect.
To issue this command, the following conditions must be satisfied:
- IMS Connect must be active and configured to communicate with the Common Service Layer (CSL) Structured Call Interface (SCI).
- A type-2 command environment with Structured Call Interface (SCI) and Operations Manager (OM) must be active.
Syntax
Keywords
The following keywords are valid for the QUERY IMSCON TYPE(CONFIG) command.
- SHOW
- Specifies the optional output fields to be displayed. Output fields that are always displayed,
regardless of whether SHOW is specified, include the name of the IMS Connect that processes the command, and the completion code.
The filters that are supported with the SHOW keyword, which can be specified in any order, are:
- ALL
- Displays all output fields.
- ADAPTER
- Displays whether XML adapter support is enabled, the maximum number of XML converters that this instance of IMS Connect can load, and the current number of XML converters that this instance of IMS Connect has loaded.
- CM0ATOQ
- Display the name of the OTMA CM0 ACK timeout queue, as specified by the CM0ATOQ= keyword in the IMS Connect configuration file.
- CASCADE
- Displays the IMS Connect default setting for whether data store connections from this IMS Connect support the cascading of global z/OS Resource Recovery Services transactions to IMS TM data stores that are located on different z/OS images (LPARs) than IMS Connect. The IMS Connect default for cascaded transaction support is set either by the CASCADE= parameter on the HWS= statement in the HWSCFGxx member of the IMS PROCLIB data set or by using the IMS type-2 command UPDATE IMSCON TYPE(CONFIG) SET(CASCADE()).
- ICONID
- Display the name of the IMS Connect, as defined in the ID substatement of the HWS configuration statement in the HWSCFGxx configuration member.
- IDLETO
- Displays the global setting for the amount of time open socket connections can remain idle in RECV state before they are terminated due to inactivity. The global settings serves as the default IDLETO value for ports that are defined by the PORT or PORTID parameters in the TCPIP configuration statement for communication with IMS TM.
The value displayed is the value of the IDLETO= parameter in the TCPIP statement in the IMS Connect configuration file.
The value shown is hundredths of seconds. Timeout values can be from 0 to 2 147 483 647 (X'7FFFFFFF'). A value of 0 means this timeout function is disabled, which prevents inactive connections from timing out.
This global-level idle timeout value can be overridden by the port-level idle timeout level.
- IPADDR
- Displays the IP address for this instance of IMS Connect. Client application programs use this IP address to connect to IMS Connect.
- MAXLSSSZ
- Displays the maximum language structure segment size. This value is passed to the XML converter when it is called.
- MAXSOC
- Displays the maximum total number of sockets that this instance of IMS Connect can open. The maximum number of physical connections that can be made is the MAXSOC= value minus the number of ports, because IMS Connect uses one socket on each port for listening.
- MULTIRTP
- Displays the current specification of the MULTIRTP keyword for this IMS Connect instance. The value displayed is the default value for all DATASTORE connections that do not specify a MULTIRTP value themselves. The MULTIRTP value determines whether the OTMA tpipes support multiple active resume tpipe requests.
- NUMSOC
- Displays the current number of sockets.
- ODBMAC
- Displays the ODBM auto connection value, which indicates whether the instance of IMS Connect identified in the ID field is configured to automatically connect to the instances of ODBM in the IMSplex in which IMS Connect is a member.
ODBMAPPL
- Displays the application name that is used, along with the user ID and the PassTicket, by IMS Connect on the RACF® call
RACROUTE REQUEST=VERIFYto authenticate connections from DRDA clients through ODBM to IMS DB. - ODBMIPMEM
- Displays the ODBM IMSplex member name, which is the name of the IMS Connect that SCI uses to manage communications between IMS Connect and ODBM.
- ODBMTMEM
- Displays the ODBM IMSplex TMEMBER name, which is the name of the SCI that manages the communication between IMS Connect and ODBM.
- ODBMTO
- Displays the ODBM timeout value, which is the time interval that IMS Connect waits before disconnecting a client application program that uses the Open Database architecture.
- ODRACFST
- Displays the RACF statistics option value that is used to enable or disable RACF statistics when connections to IMS DB through ODBM are authenticated.
- PSWDMC
- Indicates whether mixed-case password support is currently enabled for this instance of IMS Connect.
- RACF
- Indicates whether RACF support is currently enabled for this instance of IMS Connect.
- RACFGENRC
- Displays whether a generic return code or message is returned if RACF is used to verify sign-ons to IMS from IMS Connect clients and the user ID or password provided is invalid. Whether a generic return code or message is returned is set by one of the following methods:
- The RACFGENRC= parameter on the HWS= statement in the HWSCFGxx member of the IMS PROCLIB data set
- The IMS type-2 command UPDATE IMSCON TYPE(CONFIG) SET(RACFGENRC())
- RECORDER
- Indicates whether the line trace data set is open or closed.
- RRS
- Displays the following z/OS Resource Recovery Services (RRS) information for
this instance of IMS Connect:
- Whether RRS is enabled in the HWS configuration file
- The current status of RRS
- SENDALTP
-
Displays the current specification of the SENDALTP keyword for this IMS Connect instance. This value is the default value for all the data store connections that do not specify a SENDALTP value.
The SENDALTP value determines whether the ALTPCB output is sent back to the originating IMS Connect client that submits the commit-then-send send-receive transactions.
- SMEM
- Displays the OTMA super member name.
- TCPIPQ
- Displays the maximum number of queued connection requests without assigned sockets that this IMS Connect can maintain.
- TIMEOUT
- Displays the interval of time IMS Connect waits before
disconnecting a client application program after either of the following situations:
- Waiting for a response for the client from IMS
- Waiting for data from the client after the client opens a socket connection
- TMRACFST
- Displays the RACF statistics option value that is used to enable or disable RACF statistics when connections to IMS TM are authenticated.
- UIDAGE
- Displays the RACF user ID aging value in seconds. When the RACF user ID aging value is reached, IMS Connect refreshes the user ID before it processes the next input message for that user ID. Valid values are from 0 to 2,147,483,647 seconds. UIDAGE is only effective when RACF user ID caching is enabled.
- UIDCACHE
- Displays whether RACF user ID caching is used when RACF authentication is enabled.
- VERSION
- Displays the version of this instance of IMS Connect.
- WARNINC
- Displays the warning incremental percentage, which is a decimal value between 1 - 50. After the warning level (WARNSOC value in the TCPIP configuration statement) has been reached, IMS Connect will reissue an HWSS0772W message each time the number of sockets increases by the warning incremental percentage.
- WARNSOC
- Displays the warning level as a percentage of the maximum sockets limit (MAXSOC= value in the TCPIP configuration statement), which is a decimal value from 50 to 98. When the number of sockets increases to this warning level, IMS Connect issues an HWSS0772W message.
Usage notes
You can issue the QUERY IMSCON TYPE(CONFIG) command only through the Operations Manager (OM) API.
IMS Connect can process IMS Connect type-2 commands only if the IMSplex from which the commands were issued has a status of ACTIVE.
Equivalent WTOR and z/OS commands
The following table lists WTOR (Write to Operator with Reply) and IMS Connect z/OS commands that perform similar functions as the QUERY IMSCON TYPE(CONFIG) command.
Notes:
- IMS Connect WTOR commands are replies to the outstanding IMS Connect reply message.
- IMS Connect z/OS commands are issued through the z/OS (MVS™) interface by using the IMS Connect jobname.
| QUERY IMSCON TYPE(CONFIG) command | Equivalent IMS Connect WTOR command | Equivalent IMS Connect z/OS command |
|---|---|---|
| QUERY IMSCON TYPE(CONFIG) SHOW(ALL | show_parm) | VIEWHWS | QUERY MEMBER TYPE(IMSCON) SHOW(ALL) |
Output fields
- Short label
- Contains the short label that is generated in the XML output.
- Long label
- Contains the column heading displayed on the TSO SPOC screen.
- Keyword
- Identifies the keyword on the command that caused the field to be generated. N/A (not applicable) appears for output fields that are always returned. error appears for output fields that are returned only in the case of an error.
- Meaning
- Provides a brief description of the output field.
| Short label | Long label | Keyword | Meaning |
|---|---|---|---|
| ADAP | Adapter | ADAPTER | Whether XML adapter support is enabled or disabled:
|
| CASCD | Cascade | CASCADE | Shows the IMS Connect default specification for support for cascading global RRS transactions to IMS TM data stores that are located on different LPARs than IMS Connect. This specification was set either by the CASCADE= parameter of the HWS= statement in the HWSCFGxxmember of the IMS PROCLIB data set or by the type-2 UPDATE IMSCON TYPE(CONFIG) SET(CASCADE())
command. The value shown here can be overridden in the definition of an individual data store connection. One of the following values is displayed:
|
| CC | CC | N/A | Completion code that indicates whether IMS Connect was able to process the command for the specified resource. The completion code is always returned. See Table 4. |
| CCTXT | CCText | error | Completion code text that briefly explains the meaning of the nonzero completion code. This field is returned only for an error completion code. |
| CM0ATOQ | Cm0Atoq | CM0ATOQ | The name of the OTMA CM0 ACK timeout queue, as specified by the CM0ATOQ= keyword in the IMS Connect configuration file. |
| ICID | IconID | ICONID | The name of the IMS Connect, as defined in the ID substatement of the HWS configuration statement in the HWSCFGxx configuration member. |
| IP | IpAddress | IPADDR | The IP address for this instance of IMS Connect. Client application programs use this IP address to connect to IMS Connect. |
| ITO | IdleTO | IDLETO | Timeout value for an idle socket connection in RECV state. |
| MBR | MbrName | N/A | Identifier of the IMS Connect that built the output line. The identifier is always returned. |
| MCNV | MaxCvrt | ADAPTER | The maximum number of XML converters that this IMS Connect instance can load concurrently. |
| MLSS | MaxLSSSz | MAXLSSSZ | The maximum language structure segment size, which is passed to the XML converters. |
| MRTP | MultiRTP | MULTIRTP | The current specification of MULTIRTP for this IMS Connect instance. The value displayed here can be overridden by the MULTIRTP specification on the DATASTORE connection definition. Possible values include:
|
| MSOC | MaxSoc | MAXSOC | The maximum total number of sockets that this instance of IMS Connect can open. The maximum number of physical connections that can be made is the MAXSOC= value minus the number of ports, because IMS Connect uses one socket on each port for listening. |
| NCNV | NumCvrt | ADAPTER | The number of XML converters currently loaded in this instance of IMS Connect. |
| NSOC | NumSoc | NUMSOC | The current number of sockets. |
| OAC | ODBMAC | ODBMAC | The ODBM auto connection value, which indicates whether the instance of IMS Connect identified in the ID field is configured to
automatically connect to the instances of ODBM in the IMSplex in which IMS Connect is a member.
|
| OAPPL |
ODBMAppl |
ODBMAPPL |
The application name that is used, along with the user ID and the PassTicket, by IMS Connect on the RACF call RACROUTE REQUEST=VERIFY to authenticate connections from DRDA
clients through ODBM to IMS DB. |
| OIMEM | ODBMIpMem | ODBMIPMEM | The ODBM IMSplex member name, which is the name of the IMS Connect that SCI uses to manage communications between IMS Connect and ODBM. |
| ORSTAT | ODBMRacfStat | ODRACFST | Whether RACF statistics are recorded and updated when IMS Connect issues the RACF command RACROUTE REQUEST=VERIFY to authenticate ODBM client connections to
IMS DB. One of the following values is displayed:
|
| OTIMO | ODBMTO | ODBMTO | The ODBM timeout value, which is the time interval that IMS Connect waits before disconnecting a client application program that uses the Open Database architecture. |
| OTMEM | ODBMTMem | ODBMTMEM | The ODBM IMSplex TMEMBER name, which is the name of the SCI that manages the communication between IMS Connect and ODBM. |
| PMC | PswdMc | PSWDMC | Whether mixed-case password support is currently enabled for this instance of
IMS Connect. One of the following values is displayed:
|
| RACF | Racf | RACF | Whether RACF support is currently
enabled for this instance of IMS Connect. One of the following
values is displayed:
|
| RACFGRC |
RacfGenRc |
RACFGENRC |
Whether the RACF generic return code is returned when RACF rejects an attempt from an IMS Connect client to sign on to IMS:
|
| RCDR | Recorder | RECORDER | Whether the line trace data set is open or closed. One of the following values
is displayed:
|
| RRS | RRS | RRS | Whether RRS is enabled in the HWS
configuration file:
|
| RSTT | RRSStat | RRS | The current status of RRS:
|
| SALTP |
SendALTP |
SENDALTP |
The current specification of the SENDALTP keyword for this IMS Connect
instance. This value can be overridden by the SENDALTP specification in the data store connection
definition. Possible values include:
|
| SMEM | SMem | SMEMBER | The OTMA super member name. |
| TCPQ | TCPIPQ | TCPIPQ | The maximum number of queued connection requests without assigned sockets. |
| TIMO | TimeOut | TIMEOUT | The interval of time that IMS Connect
waits before disconnecting a client application program after either of the following situations:
|
| TRSTAT | TMRacfStat | TMRACFST | Whether RACF statistics are recorded
and updated when IMS Connect issues the RACF command RACROUTE REQUEST=VERIFY to authenticate OTMA
client connections to IMS TM. One of the following values is displayed:
|
| UIDA | UidAge | UIDAGE | The RACF user ID aging value in seconds. When the RACF user ID aging value is reached, IMS Connect refreshes the user ID before it processes the next input message for that user ID. Valid values are from 0 to 2,147,483,647 seconds. UIDAGE is effective only when RACF user ID caching is enabled. |
| UIDC | UidCache | UIDCACHE | Whether RACF user ID caching is used
when RACF authentication is enabled:
|
| VER | Version | VERSION | The version of this instance of IMS Connect. |
| WINC | WarnInc | WARNINC | The warning incremental percentage, which is a decimal value between 1 - 50. After the warning level (WARNSOC value in the TCPIP configuration statement) has been reached, IMS Connect reissues an HWSS0772W message each time the number of sockets increases by the warning incremental percentage. |
| WSOC | WarnSoc | WARNSOC | The warning level as a percentage of the maximum sockets limit (MAXSOC= value in the TCPIP configuration statement), which is a decimal value from 50 to 98. When the number of sockets increases to this warning level, IMS Connect issues an HWSS0772W message. |
Return and reason codes
The return and reason codes that can be returned as a result of the QUERY IMSCON TYPE(CONFIG) 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.
| Return code | Reason code | Meaning |
|---|---|---|
| X'00000000' | X'00000000' | The QUERY IMSCON TYPE(CONFIG) command completed successfully. The command output contains a line for each resource, accompanied by its completion code. See the Completion codes table for details. |
| X'0C00000C' | X'00003000' | The command was successful for some resources but failed for others. The command output contains a line for each resource, accompanied by its completion code. |
| X'0C00000C' | X'00003004' | The command was not successful for any resource. The command output contains a line for each resource, accompanied by its completion code. |
| X'0C000014' | X'00005008' | The command processor failed to obtain storage via BPEGETM. |
Completion codes
Errors unique to the processing of this command are returned as completion codes. A completion code is returned for each action against an individual resource.
| Completion code | Completion code text | Meaning |
|---|---|---|
| 0 | The QUERY IMSCON TYPE(CONFIG) command completed successfully for the resources. |
Examples
Example 1 for QUERY IMSCON TYPE(CONFIG) command
TSO SPOC input:
QUERY IMSCON TYPE(CONFIG) SHOW(ALL)TSO SPOC output:
(screen 1)
MbrName CC Version IconID IpAddress MaxSoc TimeOut NumSoc
HWS1 0 V14 HWS1 127.0.0.1 50 2147483647 4
(screen 2)
MbrName WarnSoc WarnInc TCPIPQ UidCache UidAge RACF PswdMc RRS
HWS1 80 5 2147483647 Y 2147483647 N N N
(screen 3)
MbrName RRSStat Recorder SMem Cm0Atoq Adapter MaxCvrt NumCvrt
HWS1 REGISTERED N SM01 Y 400 15
(screen 4)
MbrName ODBMAC ODBMTO ODBMIpMem ODBMTMem MaxLSSSz
HWS1 Y 18000 HWS1 PLEX1 32767
(screen 5)
MbrName MultiRTP Cascade ODBMRacfStat IdleTO TMRacfStat RacfGenRc
HWS1 N N N 5000 N N
(screen 6)
MbrName ODBMAppl
HWS1 MYDBAPPL
OM API input:
CMD ( QUERY IMSCON TYPE(CONFIG) SHOW(ALL) )OM API output:
<?xml version="1.0"?>
<!DOCTYPE imsout SYSTEM "imsout.dtd">
<imsout>
<ctl>
<omname>OM1OM </omname>
<omvsn>1.7.0</omvsn>
<xmlvsn>20 </xmlvsn>
<statime> 2014.118 22:49:29.653223</statime>
<stotime> 2014.118 22:49:29.663453</stotime>
<staseq>C9F23082045267A5</staseq>
<stoseq>C9F23082046F18A5</stoseq>
<rqsttkn1>USRT002 10142849</rqsttkn1>
<rc>00000000</rc>
<rsn>00000000</rsn>
</ctl>
<cmd>
<master>HWS1 </master>
<userid>USRT002 </userid>
<verb>QRY </verb>
<kwd>IMSCON </kwd>
<input>QUERY IMSCON TYPE(CONFIG) SHOW(ALL) </input>
</cmd>
<cmdrsphdr>
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="1" 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="32" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="VER" llbl="Version" scope="LCL" sort="n" key="0"
scroll="yes" len="3" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="ICID" llbl="IconID" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="IP" llbl="IpAddress" scope="LCL" sort="n" key="0"
scroll="yes" len="15" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="MSOC" llbl="MaxSoc" scope="LCL" sort="n" key="0"
scroll="yes" len="5" dtype="INT" align="right" skipb="yes" />
<hdr slbl="TIMO" llbl="TimeOut" scope="LCL" sort="n" key="0"
scroll="yes" len="10" dtype="int" align="right" skipb="yes" />
<hdr slbl="NSOC" llbl="NumSoc" scope="LCL" sort="n" key="0"
scroll="yes" len="5" dtype="INT" align="right" skipb="yes" />
<hdr slbl="WSOC" llbl="WarnSoc" scope="LCL" sort="n" key="0"
scroll="yes" len="2" dtype="INT" align="right" skipb="yes" />
<hdr slbl="WINC" llbl="WarnInc" scope="LCL" sort="n" key="0"
scroll="yes" len="2" dtype="INT" align="right" skipb="yes" />
<hdr slbl="TCPQ" llbl="TCPIPQ" scope="LCL" sort="n" key="0"
scroll="yes" len="10" dtype="INT" align="right" skipb="yes" />
<hdr slbl="UIDC" llbl="UidCache" scope="LCL" sort="n" key="0"
scroll="yes" len="1" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="UIDA" llbl="UidAge" scope="LCL" sort="n" key="0"
scroll="yes" len="10" dtype="INT" align="right" skipb="yes" />
<hdr slbl="RACF" llbl="RACF" scope="LCL" sort="n" key="0" scroll="yes"
len="1" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="PMC" llbl="PswdMc" scope="LCL" sort="n" key="0" scroll="yes"
len="1" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RRS" llbl="RRS" scope="LCL" sort="n" key="0" scroll="yes"
len="1" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RSTT" llbl="RRSStat" scope="LCL" sort="n" key="0"
scroll="yes" len="10" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RCDR" llbl="Recorder" scope="LCL" sort="n" key="0"
scroll="yes" len="1" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="SMEM" llbl="SMem" scope="LCL" sort="n" key="0" scroll="yes"
len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="CM0ATOQ" llbl="Cm0Atoq" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="ADAP" llbl="Adapter" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="MCNV" llbl="MaxCvrt" scope="LCL" sort="n" key="0"
scroll="yes" len="5" dtype="INT" align="right" skipb="yes" />
<hdr slbl="NCNV" llbl="NumCvrt" scope="LCL" sort="n" key="0"
scroll="yes" len="5" dtype="INT" align="right" skipb="yes" />
<hdr slbl="OAC" llbl="ODBMAC" scope="LCL" sort="n" key="0" scroll="yes"
len="1" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="OTIMO" llbl="ODBMTO" scope="LCL" sort="n" key="0"
scroll="yes" len="10" dtype="INT" align="right" skipb="yes" />
<hdr slbl="OIMEM" llbl="ODBMIpMem" scope="LCL" sort="n" key="0"
scroll="yes" len="16" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="OTMEM" llbl="ODBMTMem" scope="LCL" sort="n" key="0"
scroll="yes" len="16" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="MLSS" llbl="MaxLSSSz" scope="LCL" sort="n" key="0"
scroll="yes" len="5" dtype="INT" align="right" skipb="yes" />
<hdr slbl="MRTP" llbl="MultiRTP" scope="LCL" sort="n" key="0"
scroll="yes" len="1" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="CASCD" llbl="Cascade" scope="LCL" sort="n" key="0"
scroll="yes" len="1" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="ORSTAT" llbl="ODBMRacfStat" scope="LCL" sort="n" key="0"
scroll="yes" len="1" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="ITO" llbl="IdleTO" scope="LCL" sort="n" key="0"
scroll="yes"len="10" dtype="INT" align="right" skipb="yes" />
<hdr slbl="TRSTAT" llbl="TMRacfStat" scope="LCL" sort="n" key="0"
scroll="yes" len="1" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="RACFGRC" llbl="RacfGenRc" scope="LCL" sort="n" key="0"
scroll="yes" len="1" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="OAPPL" llbl="ODBMAppl" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
</cmdrsphdr>
<cmdrspdata>
<rsp>MBR(HWS1 ) CC( 0) VER(V14) ICID(HWS1 )
IP(127.0.0.1) MSOC( 50) TIMO(2147483647) NSOC( 4) WSOC(80)
WINC( 5) TCPQ(2147483647) UIDC(Y) UIDA(2147483647) RACF(N) PMC(N) RRS(N)
RSTT(REGISTERED) RCDR(N) SMEM(SM01) CM0ATOQ( ) ADAP(Y)
MCNV(400) NCNV(15) OAC(Y) OTIMO( 18000) OIMEM(HWS1 )
OTMEM(PLEX1 ) MLSS(32767) MRTP(N) CASCD(N) ORSTAT(N)
ITO(5000) TRSTAT(N) RACFGRC(N) OAPPL(MYDBAPPL)
</rsp>
</cmdrspdata>
</imsout>Explanation: This command shows general status related to IMS Connect.
Example 2 for QUERY IMSCON TYPE(CONFIG) command
In the following example, the ODRACFST keyword is used to display the current value of the ODRACFST= option, which is defined in the ODACCESS statement of the HWSCFGxx member.
TSO SPOC input:
QRY IMSCON TYPE(CONFIG) SHOW(ODRACFST)TSO SPOC
output:
MbrName CC ODBMRacfStat
HWS1 0 YOM API input:
CMD(QRY IMSCON TYPE(CONFIG) SHOW(ALL))OM API
output:
<?xml version="1.0"?>
<!DOCTYPE imsout SYSTEM "imsout.dtd">
<imsout>
<ctl>
<omname>OM1OM </omname>
<omvsn>1.7.0</omvsn>
<xmlvsn>20 </xmlvsn>
<statime>2017.111 00:29:35.253108</statime>
<stotime>2017.111 00:29:35.253390</stotime>
<staseq>D26B2A2D6B674CF1</staseq>
<stoseq>D26B2A2D6B78E8F1</stoseq>
<rqsttkn1>USRT011 10172935</rqsttkn1>
<rc>00000000</rc>
<rsn>00000000</rsn>
</ctl>
<cmd>
<master>HWS1 </master>
<userid>USRT011 </userid>
<verb>QRY </verb>
<kwd>IMSCON </kwd>
<input>QRY IMSCON TYPE(CONFIG) SHOW(ODRACFST) </input>
</cmd>
<cmdrsphdr>
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="1" 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="32" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="ORSTAT" llbl="ODBMRacfStat" scope="LCL" sort="n" key="0"
scroll="yes" len="1" dtype="CHAR" align="left" skipb="yes" />
</cmdrsphdr>
<cmdrspdata>
<rsp>MBR(HWS1 ) CC( 0) ORSTAT(Y) </rsp>
</cmdrspdata>
</imsout>
Example 3 for QUERY IMSCON TYPE(CONFIG) command
In the following example, the IMS Connect instance has a global-level IDLETO value of 0. If any port does not define its own IDLETO value, it will use this global-level IDLETO value, and its port connection idle timeout function is disabled.
TSO SPOC input:
QUERY IMSCON TYPE(CONFIG) SHOW(IDLETO)TSO SPOC output:
Response for: QRY IMSCON TYPE(CONFIG) SHOW(IDLETO)
MbrName CC IdleTO
HWS1 0 0
OM API input:
CMD(QRY IMSCON TYPE(CONFIG) SHOW(IDLETO))OM API output:
<cmdrsphdr>
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="1" 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="32" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="ITO" llbl="IdleTO" scope="LCL" sort="n" key="0" scroll="yes"
len="10" dtype="INT" align="right" skipb="yes" />
</cmdrsphdr>
<cmdrspdata>
<rsp>MBR(HWS1 ) CC( 0) ITO(0) </rsp>
</cmdrspdata>
Example 4 for QUERY IMSCON TYPE(CONFIG) command
In the following example, the ODBMAPPL keyword is used to display the current value of the APPL= option, which is defined in the ODACCESS statement of the HWSCFGxx member.
TSO SPOC input:
QUERY IMSCON TYPE(CONFIG) SHOW(ODBMAPPL)TSO SPOC output:
MbrName CC ODBMAppl
HWS1 0 MYDBAPPL
OM API input:
CMD(QUERY IMSCON TYPE(CONFIG) SHOW(ODBMAPPL))OM API output:
<?xml version="1.0"?>
<!DOCTYPE imsout SYSTEM "imsout.dtd">
<imsout>
<ctl>
<omname>OM1OM </omname>
<omvsn>1.7.0</omvsn>
<xmlvsn>20 </xmlvsn>
<statime>2018.149 23:40:31.820937</statime>
<stotime>2018.149 23:40:31.828560</stotime>
<staseq>D46710B490089549</staseq>
<stoseq>D46710B491E50A4D</stoseq>
<rqsttkn1>USRT011 10164031</rqsttkn1>
<rc>00000000</rc>
<rsn>00000000</rsn>
</ctl>
<cmd>
<master>HWS1 </master>
<userid>USRT011 </userid>
<verb>QRY </verb>
<kwd>IMSCON </kwd>
<input>QRY IMSCON TYPE(CONFIG) SHOW(ODBMAPPL) </input>
</cmd>
<cmdrsphdr>
<hdr slbl="MBR" llbl="MbrName" scope="LCL" sort="a" key="1" 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="32" dtype="CHAR" align="left" skipb="yes" />
<hdr slbl="OAPPL" llbl="ODBMAppl" scope="LCL" sort="n" key="0"
scroll="yes" len="8" dtype="CHAR" align="left" skipb="yes" />
</cmdrsphdr>
<cmdrspdata>
<rsp>MBR(HWS1 ) CC( 0) OAPPL(MYDBAPPL) </rsp>
</cmdrspdata>
</imsout>