UPDATE IMSCON TYPE(CONFIG) command

Use the UPDATE IMSCON TYPE(CONFIG) command to terminate IMS Connect with the option QUIESCE or FORCE, to open and close the line trace data set, and to enable and disable features such as ODBM registration, password support, RACF®, and z/OS® Resource Recovery Services (RRS).

Subsections:

Environment

The UPDATE 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

Start of change
Read syntax diagramSkip visual syntax diagramUPDATEUPD IMSCON TYPE(CONFIG) SHUTDOWN(COMM)OPTION(QUIESCE)OPTION(FORCE)START(RECORDER)STOP(RECORDER)SET(CASCADE(OFFON)IDLETO( timeout_value)MULTIRTP(0OFFON)OAUTO(ONOFF)ODBMAPPL(0application_name)ODRACFST(ONOFF)PSWDMC(ONOFFRCF)RACF(ONOFF)RACFGENRC(OFFON)RRS(ONOFF)SENDALTP(0ONOFF)TMRACFST(ONOFF)UIDCACHE(ONOFF))
End of change

Keywords

The following keywords are valid for the UPDATE IMSCON TYPE(CONFIG) command.

SHUTDOWN(COMM)
Specifies that IMS Connect ends all client and data store connections in a controlled manner.
OPTION
Specifies an option for SHUTDOWN.
QUIESCE
Ends all client and data store connections in a controlled manner. If no parameter is specified for the SHUTDOWN keyword, QUIESCE is used by default.

All work that is in progress, or that is queued for processing, is completed before IMS Connect is stopped. No new work is accepted after this command is entered and accepted.

IMS Connect shuts down in the following sequence:
  1. All active units of work for clients and browsers are completed.
  2. Communication between IMS Connect and IMS is terminated.
  3. IMS Connect terminates.
FORCE
Ends all client and data store connections immediately. This keyword forces any IMS applications that are being run for the connected clients to end abnormally.
SET
Specifies the attribute values to be changed.
CASCADE=
Defines the IMS Connect default setting for support for cascading global, two-phase commit (synclevel=syncpoint) transactions from IMS TM Resource Adapter via a TCP/IP connection to an IMS TM or IMS DB/DC system that is on a different z/OS image than IMS Connect. Cascading transactions that are received via a LOCAL option connection is not supported.

A CASCADE specification in the definition of a data store connection overrides the CASCADE specification in the IMS Connect system configuration. Any data store connection definition that does not specify a value for CASCADE inherits the CASCADE specification from the IMS Connect system configuration.

Until the next restart of IMS Connect, a CASCADE specification made by the UPDATE IMSCON TYPE(CONFIG) SET(CASCADE()) command overrides the CASCADE specification on the HWS configuration statement.

The CASCADE parameter applies only to the support for cascading global, RRS transactions between IMS Connect and IMS TM when they are on different z/OS images. The specification of the IMS Connect CASCADE parameter does not affect support between other components or subsystems, such as between IMS subsystems in a shared queues environment.

OFF
Specifies that, by default, data store connections do not support the cascading of global, two-phase commit (synclevel=syncpoint) transactions to IMS TM and IMS DB/DC systems that are running on a different z/OS image than IMS Connect.

If a synclevel=syncpoint transaction is routed to an IMS system that resides on a different LPAR than IMS Connect, IMS Connect rejects the transaction with return code 4 and reason code NCASCADE.

ON
Specifies that, by default, data store connections support the cascading of global, two-phase commit (synclevel=syncpoint transactions to IMS TM and IMS DB/DC systems that are running on different z/OS images than IMS Connect.

If IMS Connect and IMS reside on the same LPAR, the transaction is processed without using cascaded transaction support. If IMS Connect and IMS reside on different LPARs, the transaction is processed using cascaded transaction support.

IDLETO

For ports defined for communications with IMS TM, specifies the global timeout interval for open socket connections that are idle and are waiting in a RECV state for the next message. The global timeout value can be overridden for individual ports that are defined by the PORT= parameter by specifying IDLETO= in the port definition.

When the timeout interval expires, IMS Connect closes the socket connection due to inactivity.

The timeout interval is in hundredths of seconds. Timeout values can be 0 - 2 147 483 647 (X'7FFFFFFF'). A value of 0 disables this timeout function, which prevents inactive connections from timing out.

This parameter is optional and applies only to persistent socket connections.

MULTIRTP=
Sets the IMS Connect default specification for OTMA multiple RESUME TPIPE (MULTIRTP) support.

The IMS Connect default specification for MULTIRTP support can be overridden for individual DATASTORE connections by specifying a MULTIRTP value in the DATASTORE definition.

If MULTIRTP is not specified on either the HWS statement or a DATASTORE statement, the OTMA MULTIRTP value defines the default.

For an active DATASTORE connection that does not specify a MULTIRTP value, you can use the UPDATE IMSCON TYPE(CONFIG) SET(MULTIRTP()) command to specify a MULTIRTP value. The specification takes effect after the DATASTORE connection is restarted.

0
The numeric character 0 removes any existing MULTIRTP specification from the IMS configuration so that, by default, data store client bid requests do not include any specification for MULTIRTP support. MULTIRTP support is determined by either the DATASTORE definition or the OTMA client descriptor in the DFSYDTx member of the PROCLIB data set.
OFF
Specifies that IMS Connect client bid requests indicate that IMS Connect requires an OTMA tpipe that supports only a single active RESUME TPIPE request. Output messages on the tpipe are sent serially.
ON
Specifies that IMS Connect client bid requests require an OTMA TPIPE that can support multiple active RESUME TPIPE requests in parallel. When a tpipe has multiple active RESUME TPIPE requests from multiple DATASTORE connections, OTMA sends the callout or CM0 output messages on the first available DATASTORE connection that is in a receive state.
OAUTO
Specifies whether IMS Connect automatically connects to ODBM when an instance of ODBM is activated in the IMSplex.
ON
IMS Connect will connect to all the future ODBMs that enter the IMSplex. This option can be specified in the ODBMATOCONN= parameter of the IMS Connect configuration member.
OFF
IMS Connect will not register with any future ODBMs that enter the IMSplex. After turning off the automatic connection of IMS Connect to ODBM, you can connect to ODBM manually by using the UPDATE IMSCON TYPE(ODBM) START(COMM) or equivalent command to open communication with an instance of ODBM.
Start of changeODBMAPPLEnd of change
Start of changeEnd of change
Start of changeSpecifies 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.

The application name that is defined on this keyword is the application name that is defined to RACF in the PTKTDATA class.

If a value of 0 (zero) is specified, the application name is set to blanks.

End of change
ODRACFST
Specifies whether RACF statistics are recorded and updated when IMS Connect issues the RACROUTE REQUEST=VERIFY command to authenticate connections from an ODBM client to IMS DB.

This keyword is used only if RACF=Y is specified in the HWS statement of the HWSCFGxx configuration member.

ON
RACF statistics are recorded and updated when IMS Connect issues the RACROUTE REQUEST=VERIFY command to authenticate connections from an ODBM client to IMS DB. If the logon is successful, a message is also issued. When you specify ODRACFST=Y, the STAT=ASIS parameter is used by IMS Connect on the RACROUTE REQUEST=VERIFY command. With STAT=ASIS, the RACF messages and statistics are controlled by the installation's current options on the RACF command SETROPTS.

After you enable RACF statistics, the statistics are recorded by RACF no more than once per day to a system management facility (SMF) data set or log stream. The SMF data set or log stream that is used to record the RACF statistics is specified in the RACF configuration.

OFF
RACF statistics are not recorded when IMS Connect issues the RACROUTE REQUEST=VERIFY command to authenticate connections from an ODBM client to IMS DB. Also, the statistics are not updated and, if the logon is successful, no message is issued. When you specify ODRACFST=N, the STAT=NO parameter is used by IMS Connect on the RACROUTE REQUEST=VERIFY command. With STAT=NO, the options specified on the RACF command SETROPTS are ignored.

For more information about the STAT= parameter of the RACROUTE REQUEST=VERIFY macro call, see "z/OS Security Server RACROUTE Macro Reference" in the IBM® z/OS documentation.

PSWDMC
Specifies whether IMS Connect support for mixed-case passwords is to be turned on or off, or if it depends on the mixed-case password specification in RACF.
ON
Enables IMS Connect support for mixed-case passwords.
OFF
Disables IMS Connect support for mixed-case passwords. If mixed-case password support is disabled, IMS Connect converts any lowercase characters in passwords to uppercase characters.
RCF
Depends on the mixed-case password specification in RACF. If it is off, IMS Connect converts any lowercase characters in passwords to uppercase characters.
RACF
Specifies that the RACF flag is to be turned on or off.
ON
Enables the RACF user identification and verification.
OFF
Disables the RACF user identification and verification.
Start of changeRACFGENRCEnd of change
Start of changeSpecifies whether a generic return code or message is returned by IMS Connect if RACF is used to verify sign-ons to IMS from IMS Connect clients and the user ID or password provided is invalid.
OFF
IMS Connect returns normal RACF return codes.
ON
IMS Connect returns one of the following generic return codes or message instead of the actual RACF return code, depending on the IMS Connect client:
  • For non-TMRA OTMA clients, RSM_RACFRC=255 for security errors (RSM_RETCODE=8, RSM_RSNCOD=40)
  • For TMRA OTMA clients, OMUSR_RACF_RC=255 for security errors (OMUSR_RETCODE=8, OMUSR_RESCODE='SECFAIL')
  • For DRDA clients:
    • SECCHKCD(codepoint x'11A4')=x'19'
    • HWSK2865E R=255, RACFRC=255, RACFRSN=0
  • For failed password change requests, message HWSC0038E PASSWORD CHANGE ERROR
End of change
RRS
Specifies that z/OS Resource Recovery Services (RRS) is to be turned on or off. RRS is required for two-phase-commit support.
ON
Enables communication between IMS Connect and RRS.
OFF
Disables communication between IMS Connect and RRS.
Start of changeSENDALTPEnd of change
Start of change
Sets the IMS Connect default specification for OTMA SENDALTP support. The IMS Connect default specification for the SENDALTP support can be overridden for individual data store connections by specifying a SENDALTP value in the DATASTORE definition. You can specify the following values on the SENDALTP parameter:
0

Removes any existing SENDALTP specification from the IMS Connect configuration. When this value is specified, by default, data store client bid requests do not include any specification for the SENDALTP support.

OFF
Disables support for sending the ALTPCB output to the originating IMS Connect client.
ON
Enables support for sending the ALTPCB output to the originating IMS Connect client that submits commit-then-send send-receive calls.
End of change
TMRACFST
Specifies whether RACF statistics are recorded and updated when IMS Connect issues the RACROUTE REQUEST=VERIFY command to authenticate connections from an OTMA client to IMS TM.

This keyword is used only if RACF=Y is specified in the HWS statement of the HWSCFGxx configuration member.

ON
RACF statistics are recorded and updated when IMS Connect issues the RACROUTE REQUEST=VERIFY command to authenticate connections from an OTMA client to IMS TM. If the logon is successful, a message is also issued. When you specify TMRACFST=Y, the STAT=ASIS parameter is used by IMS Connect on the RACROUTE REQUEST=VERIFY command. With STAT=ASIS, the RACF messages and statistics are controlled by the installation's current options on the RACF command SETROPTS.

After you enable RACF statistics, the statistics are recorded by RACF no more than once per day to a system management facility (SMF) data set or log stream. The SMF data set or log stream that is used to record the RACF statistics is specified in the RACF configuration.

OFF
RACF statistics are not recorded when IMS Connect issues the RACROUTE REQUEST=VERIFY command to authenticate connections from an OTMA client to IMS TM. Also, the statistics are not updated and, if the logon is successful, no message is issued. When you specify TMRACFST=N, the STAT=NO parameter is used by IMS Connect on the RACROUTE REQUEST=VERIFY command. With STAT=NO, the options specified on the RACF command SETROPTS are ignored.

For more information about the STAT= parameter of the RACROUTE REQUEST=VERIFY macro call, see "z/OS Security Server RACROUTE Macro Reference" in the IBM z/OS documentation.

UIDCACHE
Specifies whether RACF user ID caching is used when RACF authentication is enabled.
ON
Enables RACF user ID caching when RACF authentication is enabled.
OFF
Disables RACF user ID caching when RACF authentication is enabled.
START(RECORDER)
Starts the line trace data set for IMS Connect. This keyword is mutually exclusive with STOP(RECORDER).
STOP(RECORDER)
Stops the line trace data set for IMS Connect. This keyword is mutually exclusive with START(RECORDER).

Usage notes

You can issue the UPDATE 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.

Modifications that are made to IMS Connect resources by use of this command are not saved across restarts of IMS Connect.

Equivalent WTOR and z/OS commands

The following table lists IMS Connect WTOR (Write to Operator with Reply) and IMS Connect z/OS commands that perform similar functions as the UPDATE 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.
Table 1. WTOR and IMS Connect z/OS equivalents for the UPDATE IMSCON TYPE(CONFIG) command
UPDATE IMSCON TYPE(CONFIG) command Equivalent IMS Connect WTOR command Equivalent IMS Connect z/OS command
UPDATE IMSCON TYPE(CONFIG) SHUTDOWN(COMM) CLOSEHWS SHUTDOWN MEMBER
UPDATE IMSCON TYPE(CONFIG) SHUTDOWN(COMM) OPTION(FORCE) CLOSEHWS FORCE SHUTDOWN MEMBER OPTION(FORCE)
UPDATE IMSCON TYPE(CONFIG) SHUTDOWN(COMM) OPTION(QUIESCE) CLOSEHWS QUIESCE SHUTDOWN MEMBER OPTION(QUIESCE)
UPDATE IMSCON TYPE(CONFIG) SET(OAUTO(ON)) SETOAUTO YES UPDATE MEMBER TYPE(IMSCON) SET(OAUTO(ON))
UPDATE IMSCON TYPE(CONFIG) SET(OAUTO(OFF) SETOAUTO NO UPDATE MEMBER TYPE(IMSCON) SET(OAUTO(OFF))
UPDATE IMSCON TYPE(CONFIG) SET(PSWDMC(ON)) SETPWMC ON UPDATE MEMBER TYPE(IMSCON) SET(PSWDMC(ON))
UPDATE IMSCON TYPE(CONFIG) SET(PSWDMC(OFF)) SETPWMC OFF UPDATE MEMBER TYPE(IMSCON) SET(PSWDMC(OFF))
UPDATE IMSCON TYPE(CONFIG) SET(PSWDMC(RCF)) SETPWMC RCF UPDATE MEMBER TYPE(IMSCON) SET(PSWDMC(RCF))
UPDATE IMSCON TYPE(CONFIG) SET(RACF(ON)) SETRACF ON UPDATE MEMBER TYPE(IMSCON) SET(RACF(ON))
UPDATE IMSCON TYPE(CONFIG) SET(RACF(OFF)) SETRACF OFF UPDATE MEMBER TYPE(IMSCON) SET(RACF(OFF))
UPDATE IMSCON TYPE(CONFIG) SET(RRS(ON)) SETRRS ON UPDATE MEMBER TYPE(IMSCON) SET(RRS(ON))
UPDATE IMSCON TYPE(CONFIG) SET(RRS(OFF)) SETRRS OFF UPDATE MEMBER TYPE(IMSCON) SET(RRS(OFF))
UPDATE IMSCON TYPE(CONFIG) SET(UIDCACHE(ON)) SETUIDC ON UPDATE MEMBER TYPE(IMSCON) SET(UIDCACHE(ON))
UPDATE IMSCON TYPE(CONFIG) SET(UIDCACHE(OFF)) SETUIDC OFF UPDATE MEMBER TYPE(IMSCON) SET(UIDCACHE(OFF))
UPDATE IMSCON TYPE(CONFIG) START(RECORDER) RECORDER OPEN UPDATE MEMBER TYPE(IMSCON) START(TRACE)
UPDATE IMSCON TYPE(CONFIG) STOP(RECORDER) RECORDER CLOSE UPDATE MEMBER TYPE(IMSCON) STOP(TRACE)

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.
Table 2. Output fields for the UPDATE IMSCON TYPE(CONFIG) command
Short label Long label Keyword Meaning
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.
MBR MbrName N/A Identifier of the IMS Connect that built the output line. The identifier is always returned.

Return and reason codes

The return and reason codes that can be returned as a result of the UPDATE 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.

Table 3. Return and reason codes for the UPDATE IMSCON TYPE(CONFIG) command
Return code Reason code Meaning
X'00000000' X'00000000' The UPDATE IMSCON TYPE(CONFIG) command completed successfully. The command output contains a line for each resource, accompanied by its completion code.
X'0C000008' X’000020C0’ The command specified an IDLETO value that was outside of the valid range. The command was rejected.
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.

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.

Table 4. Completion codes for the UPDATE IMSCON TYPE(CONFIG) command
Completion code Completion code text Meaning
0   The UPDATE IMSCON TYPE(CONFIG) command completed successfully for the resources.
10 NO RESOURCES FOUND The resource name is unknown to the client that is processing the request. The resource name might have been typed in error or the resource might not be active at this time. If a wildcard was specified in the command, there were no matches for the name. Confirm that the correct spelling of the resource name is specified on the command.
Start of change52End of change Start of changeRACFGENRC - IRRSPW00 load errEnd of change Start of changeThe SET(RACFGENRC(ON)) keyword was specified, but IMS Connect was unable to load the required SAF load module IRRSPW00. Ensure that the IRRSPW00 module provided by RACF is included in LPA, in a library in LINKLIST, or in one of the IMS.SDFSRESL concatenated data sets.End of change

Examples

Example 1 for UPDATE IMSCON TYPE(CONFIG) command

TSO SPOC input:

UPDATE IMSCON TYPE(CONFIG) SET(RRS(ON))

TSO SPOC output:

MbrName  CC
HWS1      0	

OM API input:

CMD(UPDATE IMSCON TYPE(CONFIG) SET(RRS(ON)))

OM API output:

<imsout>                                   
<ctl>                                      
<omname>OM1OM   </omname>                  
<omvsn>1.5.0</omvsn>                       
<xmlvsn>20  </xmlvsn>                      
<statime>2010.298 02:12:57.587305</statime>
<stotime>2010.298 02:12:57.590267</stotime>
<staseq>C6C77D0A01269015</staseq>                                      
<stoseq>C6C77D0A01DFB355</stoseq>                                      
<rqsttkn1>USRID01 10191257</rqsttkn1>                                  
<rc>00000000</rc>                                                      
<rsn>00000000</rsn>                                                    
</ctl>                                                                 
<cmd>                                                                  
<master>HWS1    </master>                                              
<userid>USRID01 </userid>                                              
<verb>UPD </verb>                                                      
<kwd>IMSCON          </kwd>                                            
<input>UPD IMSCON TYPE(CONFIG) SET(RRS(ON)) </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" />        
</cmdrsphdr>                                                           
<cmdrspdata>                                                           
<rsp>MBR(HWS1            ) CC(   0) </rsp>                             
</cmdrspdata>
</imsout>    

Explanation: RRS has been enabled for IMS Connect, HWS1.

Example 2 for UPDATE IMSCON TYPE(CONFIG) command

TSO SPOC input:

UPDATE IMSCON TYPE(CONFIG) SHUTDOWN(COMM) OPTION(FORCE)

TSO SPOC output:

MbrName  CC
HWS1      0	

OM API input:

CMD(UPDATE IMSCON TYPE(CONFIG) SHUTDOWN() OPTION(FORCE))

OM API output:

<imsout>                                   
<ctl>                                      
<omname>OM1OM   </omname>                  
<omvsn>1.5.0</omvsn>                       
<xmlvsn>20  </xmlvsn>                      
<statime>2010.298 02:14:58.410022</statime>
<stotime>2010.298 02:15:14.132658</stotime>
<staseq>C6C77D7D3AE26562</staseq>                                      
<stoseq>C6C77D8C396B2020</stoseq>                                      
<rqsttkn1>USRID01 10191458</rqsttkn1>                                  
<rc>00000000</rc>                                                      
<rsn>00000000</rsn>                                                    
</ctl>                                                                 
<cmd>                                                                  
<master>HWS1    </master>                                              
<userid>USRID01 </userid>                                              
<verb>UPD </verb>                                                      
<kwd>IMSCON          </kwd>                                            
<input>UPD IMSCON TYPE(CONFIG) SHUTDOWN(COMM) OPTION(FORCE) </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" />        
</cmdrsphdr>                                                           
<cmdrspdata>                                                           
<rsp>MBR(HWS1            ) CC(   0) </rsp>                             
</cmdrspdata> 
</imsout>     

Explanation: IMS Connect, HWS1, has been shut down.

Example 3 for UPDATE IMSCON TYPE(CONFIG) command

TSO SPOC input:

UPDATE IMSCON TYPE(CONFIG) START(RECORDER)

TSO SPOC output:

MbrName  CC
HWS1      0	

OM API input:

CMD(UPDATE IMSCON TYPE(CONFIG) START(RECORDER))

OM API output:

<imsout>                                   
<ctl>                                      
<omname>OM1OM   </omname>                  
<omvsn>1.5.0</omvsn>                       
<xmlvsn>20  </xmlvsn>                      
<statime>2010.298 02:32:07.499478</statime>
<stotime>2010.298 02:32:07.503090</stotime>
<staseq>C6C78152A56D6F7E</staseq>                                      
<stoseq>C6C78152A64F223E</stoseq>                                      
<rqsttkn1>USRID01 10193207</rqsttkn1>                                  
<rc>00000000</rc>                                                      
<rsn>00000000</rsn>                                                    
</ctl>                                                                 
<cmd>                                                                  
<master>HWS1    </master>                                              
<userid>USRID01 </userid>                                              
<verb>UPD </verb>                                                      
<kwd>IMSCON          </kwd>                                            
<input>UPD IMSCON TYPE(CONFIG) START(RECORDER) </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" />        
</cmdrsphdr>                                                           
<cmdrspdata>                                                           
<rsp>MBR(HWS1            ) CC(   0) </rsp>                             
</cmdrspdata>
</imsout>    

Explanation: The IMS Connect line trace data set has been opened.

Example 4 for UPDATE IMSCON TYPE(CONFIG) command

In the following example, the SET(ODRACFST(ON)) keyword is used to update the RACF statistics option so that RACF statistics are enabled when IMS Connect issues the RACROUTE REQUEST=VERIFY call for ODBM clients.

TSO SPOC input:
UPD IMSCON TYPE(CONFIG) SET(ODRACFST(ON))
TSO SPOC output:
MbrName            CC
HWS1                0
OM API input:
CMD(UPD IMSCON TYPE(CONFIG) SET(ODRACFST(ON)))
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:36:43.850434</statime>
<stotime>2017.111 00:36:43.850679</stotime>
<staseq>D26B2BC6296C2F69</staseq>
<stoseq>D26B2BC6297B7EE9</stoseq>
<rqsttkn1>USRT011 10173643</rqsttkn1>
<rc>00000000</rc>
<rsn>00000000</rsn>
</ctl>
<cmd>
<master>HWS1    </master>
<userid>USRT011 </userid>
<verb>UPD </verb>
<kwd>IMSCON          </kwd>
<input>UPD IMSCON TYPE(CONFIG) SET(ODRACFST(ON)) </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" />
</cmdrsphdr>
<cmdrspdata>
<rsp>MBR(HWS1            ) CC(   0) </rsp>
</cmdrspdata>
</imsout>

Example 5 for UPDATE IMSCON TYPE(CONFIG) command

In the following example, the global-level IDLETO value is updated to 1000 or 10 seconds.

TSO SPOC input:

UPDATE IMSCON TYPE(CONFIG) SET(IDLETO(1000))

TSO SPOC output:

MbrName            CC                                      
HWS1                0

OM API input:

CMD(UPDATE IMSCON TYPE(CONFIG) SET(IDLET0(1000)))

OM API output:

<cmd>                                                                  
<master>HWS1    </master>                                              
<userid>USRT002 </userid>                                              
<verb>UPD </verb>                                                      
<kwd>IMSCON          </kwd>                                            
<input>UPDATE IMSCON TYPE(CONFIG) SET(IDLETO(1000)) </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" />        
</cmdrsphdr>                                                           
<cmdrspdata>                                                           
<rsp>MBR(HWS1            ) CC(   0) </rsp>                             
</cmdrspdata>