VIEWHWS command

Use the VIEWHWS command to display the current activity of IMS Connect.

Subsections:

Syntax

Read syntax diagramSkip visual syntax diagramnnVIEWHWSSUMMARY

Keywords

The following keywords are valid for the VIEWHWS command:

nn
The 2-digit number of the z/OS® system console outstanding display.
SUMMARY
Excludes detailed client information. This option provides the same HWS and data store information but bypasses listing each individual client for the ports. The port status and client totals are still reported.

Usage notes

You can use the VIEWDS command to display information for data stores only or the VIEWPORT command to display information for ports only.

The VIEWHWS command displays the CONV status if a client is running an IMS conversational transaction. However, if an application sets the InteractionSpec convTypeNew property IMS to true, IMS Connect will not keep track of the conversational status of the client across iterations of the conversational transaction. Therefore, the VIEWHWS command will not display the CONV status unless the command is entered during a conversational iteration.

When IMS Connect connects to an ODBM, the status of the ODBM is REGISTERED. When a STOPOD command is issued to stop the connection to the ODBM, the status of the ODBM is changed to UNREGISTERED. When a REGISTERED ODBM goes down, the status of that ODBM is changed to NOT ACTIVE. If an alias is ACTIVE, then IMS Connect can route DRDA messages to it. If an alias is NOT ACTIVE, then IMS Connect cannot route DRDA messages to it.

Equivalent IMS Connect type-2 and z/OS commands

The following table lists IMS Connect type-2 commands and IMS Connect z/OS commands that perform similar functions as the VIEWHWS command.

VIEWHWS command Equivalent IMS Connect type-2 command Equivalent IMS Connect z/OS command
VIEWHWS QUERY IMSCON TYPE(CONFIG) SHOW(ALL|show_parm) QUERY MEMBER TYPE(IMSCON) SHOW(ALL)

Output fields

The following list shows the output fields of the VIEWHWS command.

HWS ID=
Name of the IMS Connect, as defined in the ID substatement of the HWS configuration statement in the HWSCFGxx configuration member.
RACF®
Indicates whether RACF support is currently enabled for the instance of IMS Connect identified in the HWS ID= field.
UIDCACHE
Indicates whether the RACF user ID cache is enabled for the instance of IMS Connect identified in the HWS ID= field.
UIDAGE
The length of time in seconds that a RACF user ID is used before IMS Connect refreshes it.
PSWDMC
Indicates whether mixed-case password support is currently enabled for the instance of IMS Connect identified in the HWS ID= field. R indicates that the IMS Connect support for mixed-case passwords depends on the mixed-case password specification in RACF.
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 less the number of ports, because IMS Connect uses one socket on each port for listening.
TCPIPQ
The maximum number of queued requests that IMS Connect can maintain without assigned sockets.
TIMEOUT
The interval of time IMS Connect waits before disconnecting a client application program after either waiting for a response for the client from IMS or waiting for data from the client after the client opens a socket connection.
NUMSOC
The sum of all active sockets on all defined ports, RMTIMSCON connections, and RMTCICS connections.
WARNSOC
A decimal value between 1 and 50 that indicates the warning level as a percentage of the max sockets limit (MAXSOC= value in the TCPIP configuration statement). When the number of sockets increases to this warning level, IMS Connect issues an HWSS0772W message.
WARNINC
A decimal value between 1 and 50 that indicates the warning incremental percentage. After the warning level (WARNSOC value in the TCPIP configuration statement) is reached, each time the number of sockets increases by the warning incremental percentage, IMS Connect issues an HWSS0772W message again.
RRS
Shows if RRS is set to Y or N in the HWS configuration file.
STATUS
State of RRS. The RRS state can be one of the following:
  • ACTIVE - IMS Connect restart with RRS is complete.
  • NOT ACTIVE - IMS Connect is not registered with RRS.
  • REGISTERED - IMS Connect is registered with RRS.
Start of changeMULTIRTPEnd of change
Start of changeShows the current specification of the MULTIRTP parameter in the HWS statement. Possible values are:
Y
MULTIRTP=Y is the default value for all DATASTORE connections from this IMS Connect instance. Unless this value is overridden by the MULTIRTP parameter in the DATASTORE statement, the client bid requests for DATASTORE connections made from this IMS Connect instance will request TPIPEs that support multiple active resume TPIPE requests.
N
MULTIRTP=N is the default value for all DATASTORE connections from this IMS Connect instance. Unless this value is overridden by the MULTIRTP parameter in the DATASTORE statement, the client bid requests for DATASTORE connections made from this IMS Connect instance will request TPIPEs that support only a single active resume TPIPE request.
␢
A MULTIRTP value is not specified in the HWS statement. TPIPE support for multiple resume tpipe requests is determined by either the MULTIRTP specification in the DATASTORE statement or in the OTMA client descriptor.
End of change
Start of changeCASCADEEnd of change
Start of change

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 HWSCFGxx member 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:

Y
Indicates that when IMS Connect and the IMS data store are on different z/OS images (LPARs), IMS Connect enables cascaded transaction support for all data store connections that do not have a different CASCADE value in their definitions.
N
Indicates that by default, cascaded transaction support is disabled for data store connections that do not have a different CASCADE value in their definitions.
End of change
VERSION
The version of this instance of IMS Connect.
IP-ADDRESS
The IP address for this instance of IMS Connect. Client application programs use this IP address to connect to IMS Connect.
SUPER MEMBER NAME
1-4 character OTMA super member name.
ADAPTER
Shows whether XML adapter support is enabled or disabled.
MAXCVRT
The maximum number of XML converters that this instance of IMS Connect can load concurrently. The actual number of converters that IMS Connect can load depends on the size of the converters and the IMS Connect region size.
NUMCVRT
The current number of XML converters loaded in this instance of IMS Connect.
MAXLSSSZ
Displays the maximum language structure segment size that is passed to the XML converter.
ODBM AUTO CONNECTION
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.
ODBM TIMEOUT
The time interval that IMS Connect waits before disconnecting a client application program that uses the Open Database architecture.
ODBM IMSPLEX
The names of IMS Connect and SCI that are used for communication with ODBM within an IMSplex.
MEMBER
The name of IMS Connect that SCI uses to manage communications between IMS Connect and ODBM.
TARGET MEMBER
The name of the SCI that manages the communication between IMS Connect and ODBM.
DATASTORE=
Name of the data store, as defined in the ID substatement of the DATASTORE configuration statement in the HWSCFGxx configuration member, or No active Datastores. The data store is an IMS system or, more precisely, a connection to an IMS system.
STATUS
State of the data store: ACTIVE, NOT ACTIVE or DISCONNECT.

If the data store goes down, IMS Connect is notified (from IMS OTMA through z/OS cross-system coupling facility (XCF)) of the status of the data store. When the data store is brought back up and restarted, IMS Connect is notified and automatically reconnects to the data store.

GROUP
XCF group name for the group to which the IMS Connect and IMS OTMA belong.
MEMBER
IMS Connect member name in the XCF group listed.
TARGET MEMBER
IMS OTMA member name in the XCF group listed.
STATE
Indicates the state of the OTMA server. The STATE value can have one of the following values:
AVAIL
Indicates that the OTMA server is available.
WARN
Indicates that the OTMA server has one or more resources in warning state.
SEVERE
Indicates that the OTMA server is experiencing some severe resource issues.
N/A
Indicates that OTMA has not reported status for this data store.
DEFAULT REROUTE NAME
The name of an alternative destination specified in a client reroute request.
RACF APPL NAME
The RACF APPL name for PassTicket and data store access control.
Start of changeMULTIRTPEnd of change
Start of changeShows the current specification of the MULTIRTP parameter in the DATASTORE statement for the currently displayed DATASTORE connection. Possible values are:
Y
The client bid requests for this DATASTORE connection request a TPIPE that supports multiple active resume TPIPE requests.
N
The client bid requests for this DATASTORE connection request a TPIPE that supports only a single active resume TPIPE request.
#
The client bid requests for this DATASTORE connection do not contain a MULTIRTP specification. OTMA determines whether the TPIPEs for this DATASTORE connection support multiple active resume TPIPE requests.
␢
A MULTIRTP value is not specified in the DATASTORE statement. TPIPE support for multiple resume tpipe requests is determined by either the MULTIRTP specification in the HWS statement or in the OTMA client descriptor.
End of change
Start of changeCASCADEEnd of change
Start of changeShows the specification in the data store definition 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 DATASTORE= statement in the HWSCFGxx member of the IMS PROCLIB data set or by the SET(CASCADE() keyword on type-2 command CREATE IMSCON TYPE(DATASTORE) or UPDATE IMSCON TYPE(DATASTORE).

The value shown here overrides the IMS Connect default value for CASCADE.

One of the following values is displayed:

blank
A blank value indicates that cascaded transaction support was not specified for this data store. Support for this data store is determined by the IMS Connect default specification.
Y
Indicates that when IMS Connect and the IMS data store are on different z/OS images (LPARs), this data store connection supports cascading global IMS TM transactions.
N
Indicates that by default, this data store connection does not support cascading global IMS TM transactions.
End of change
OTMA ACEE AGING VALUE
The current OTMA accessor environment element (ACEE) aging value specified in the IMS Connect DATASTORE configuration statement. The OTMA ACEE aging value determines how frequently OTMA refreshes the security definitions that are cached in an ACEE for IMS Connect.
OTMA ACK TIMEOUT VALUE
The OTMA ACK timeout value in the IMS Connect configuration member.
OTMA MAX INPUT MESSAGE
The OTMA input message flood control value in the IMS Connect configuration file.
SUPER MEMBER NAME
The name of the OTMA super member to which this data store belongs.
IMSPLEX=
Name of the IMSplex as defined in the TMEMBER parameter of the IMSplex statement in the IMS Connect configuration member HWSCFGxx.
STATUS
The state of the IMSplex.
MEMBER
IMS Connect member name as defined in the IMS Connect configuration file IMSplex statement for MEMBER= parameter.
TARGET
IMS Connect target member name as defined in the IMS Connect configuration file IMSplex statement for TMEMBER= parameter.
ODBM=
Identifies an instance of Open Database Manager (ODBM) present in the IMSplex.
STATUS
Shows whether this instance of IMS Connect is registered with the identified instance of ODBM. STATUS can have one of the following values:
  • REGISTERED - IMS Connect is registered with the identified instance of ODBM.
  • NOT ACTIVE - The identified instance of ODBM is not available.
ODBMRRS
Indicates the RRS specification in an ODBM. When IMS Connect registers with ODBM, ODBM provides IMS Connect with its RRS setting in addition to the aliases.
ALIAS
The alias name of an IMS data store defined to the instance of ODBM identified in the preceding ODBM output field.
STATUS
Shows whether the IMS system associated with the preceding alias name is active or inactive. The status can have one of the following values:
  • ACTIVE - IMS Connect can route messages to the identified alias.
  • NOT ACTIVE - IMS Connect cannot route messages to the identified alias.
MSC=
Name of the displayed MSC physical link, as specified on the LCLPLKID parameter of the MSC statement in the IMS Connect configuration member. The following additional output fields describe the status, attributes, and logical links that belong to the physical link identified in the MSC= output field:
STATUS
The state of the MSC physical link displayed in the MSC output field. A physical link can be in the following states:
ACTIVE
The MSC physical link is enabled for communications between IMS Connect and the local IMS system.
NOT ACTIVE
The MSC physical link is disabled for communications between IMS Connect and the local IMS system.
RMTPLKID
The ID of the MSC physical link at the remote IMS site, as defined in the RMTPLKID parameter of the MSC statement in the IMS Connect configuration member.
LCLIMSID
The ID of the local MSC-enabled IMS system, as defined to IMS Connect on the LCLIMS parameter of the MSC statement in the IMS Connect configuration member. This LCLIMS value must match the IMS ID that the local IMS system registers with SCI in the IMSplex. You can determine the IMS ID that is registered with SCI by issuing the QUERY IMSPLEX command in the local IMSplex.

If the second IMS ID is shown in the output, it identifies the other IMS system in an XRF couple.

RMTIMSID
The name of the remote MSC-enabled IMS system, as defined on the RMTIMS parameter of the MSC statement in the IMS Connect configuration member.
GENIMSID
The generic IMS ID that is being used for TCP/IP generic resources for MSC, as defined in the GENIMSID parameter of the MSC statement in the IMS Connect configuration member.
AFFINITY
The name of the IMS system with which the MSC logical link currently has affinity for TCP/IP generic resources.
IMSPLEX
Name of the IMSplex that manages communications between IMS Connect and the local, MSC-enabled IMS system. This name is the IMSplex name that is specified on the IMSPLEX parameter of MSC statement in the IMS Connect configuration member.

This IMSPLEX name must match the name specified on the IMSPLEX(NAME=) statement of the CSLSIxxx PROCLIB member of the SCI instance that is managing communications between IMS Connect and the IMSplex.

MEMBER
The name by which this IMS Connect is registered in the IMSplex, as defined on the MEMBER parameter in the IMSPLEX substatement of the MSC statement in the IMS Connect configuration member.

This MEMBER name must also be specified on the LCLICON parameter in the MSPLINK macro that defines this MSC physical link in the local IMS system.

TARGET MEMBER
Name of the IMSplex as defined in the TMEMBER subparameter of the IMSPLEX parameter of the MSC statement in the IMS Connect configuration member.
RMTIMSCON
The name of the IMS Connect connection that is used by this MSC physical link, as defined in the RMTIMSCON parameter of the MSC statement in the IMS Connect configuration member.
IP-ADDRESS
The IP address of the remote IMS Connect instance.
PORT
The port number used by the remote IMS Connect instance.
HOSTNAME
The host name of the remote IMS Connect instance, if one is available.
LINK
The ID of an MSC logical link that is assigned to this physical link.

The values returned for this output field are displayed in column format.

If no logical links are currently assigned to this physical link, this output field is not displayed.

PARTNERID

The ID of the remote partner for this logical link, as specified on the PARTNER parameter in the MSLINK macro that defines this logical link.

The values returned for this output field are displayed in column format.

If no logical links are currently assigned to this physical link, this output field is not displayed.

STATUS
The current state of this logical link. A logical link can have the following state:
ACTIVE
This logical link can send messages to the remote IMS Connect.

The values returned for this output field are displayed in column format.

If no logical links are currently assigned to this physical link, this output field is not displayed.

SENDCLNT
The send socket ID generated by this instance of IMS Connect to identify a send socket opened on this connection. The SENDCLNT ID is used as the client ID when establishing a socket connection with the remote IMS Connect instance.

The send socket IDs generated for sockets on connections that are used for OTMA begin with "OTM." The send socket IDs that are generated for sockets on connections that are used for MSC begin with "MSC."

The values returned for this output field are displayed in column format.

If no logical links are currently assigned to this physical link, this output field is not displayed.

RECVCLNT
The client ID that identifies the receive socket for this logical link. The client ID is generated by the remote IMS Connect instance.

The values returned for this output field are displayed in column format.

If no logical links are currently assigned to this physical link, this output field is not displayed.

ISC=
ID of the ISC configuration statement in the IMS Connect configuration member that defines the ISC link to which the following output fields apply.
STATUS
Status of this ISC link. Possible values are:
ACTIVE
This ISC link is enabled for communications between IMS Connect and the local IMS system.
NOT ACTIVE
This ISC link is disabled for communications between IMS Connect and the local IMS system.
NODE
The name of this ISC node as defined to the local IMS.
LCLIMSID
Name of the local IMS as defined in the LCLIMS parameter of the ISC statement in the IMS Connect configuration member.
IMSPLEX=
Name of the IMSplex as defined in the IMSPLEX parameter of ISC statement in the IMS Connect configuration member. If IMSPLEX is not specified in the ISC statement, the name from the first IMSPLEX statement in the configuration is displayed.
MEMBER=
Name of the member as defined in the MEMBER subparameter of the IMSPLEX parameter of the ISC statement in the IMS Connect configuration member. This is the IMS Connect member name registered to the IMSplex.
TARGET MEMBER=
Name of the IMSplex as defined in the TMEMBER subparameter of the IMSPLEX parameter of the ISC statement in the IMS Connect configuration member.
RMTCICS
Name of the remote CICS connection that this ISC link is using. The value shown here is the value specified on the RMTCICS parameter of the ISC statement in the IMS Connect configuration member.
IP-ADDRESS
The IP address of this remote CICS.
PORT
The port of this remote CICS.
HOSTNAME
The hostname of this remote CICS. This field is displayed if HOSTNAME parameter is specified in the RMTCICS statement.
CICSAPPL
The value specified on the APPLID= parameter of the DFHSIT macro definition in the remote CICS subsystem.
CICSPORT
The ID of the port that IMS Connect uses to receive messages from CICS on this ISC link. The CICSPORT is defined on the TCPIP configuration statement.
CICSNETID
The network ID of the remote CICS subsystem.
ISCUSER STATUS RECVCLNT SENDCLNT

If one or more ISC parallel sessions (ISCUSERs) are active on this ISC link, the command output contains information about each ISCUSER. The information for multiple ISCUSERs is displayed in a column format under a heading that identifies the information type. The information for each ISCUSER is displayed on its own row.

ISCUSER
Name of the ISC parallel session.
STATUS
Status of this ISCUSER.
SENDCLNT
Name of the client ID that IMS Connect uses to send messages to the remote CICS subsystem for this ISCUSER.
RECVCLNT
Name of the client ID of the remote CICS subsystem that this IMS Connect receives messages from for this ISCUSER.
RMTCICS=
Name of the remote CICS connection as defined in the ID parameter of the RMTCICS configuration statement in the IMS Connect configuration member.
STATUS=
State of the connection to the remote CICS subsystem that is identified in the RMTCICS field. Possible values include:
ACTIVE
This IMS Connect has at least one socket connection to the remote CICS subsystem identified in the RMTCICS field.
NOT ACTIVE
This IMS Connect does not have any socket connections to the remote CICS identified in the RMTCICS field.
STOPPED
Communications between this IMS Connect and the remote CICS subsystem is stopped. Any messages sent to the remote subsystem while the connection is stopped are rejected and an error message is returned to the sender.
IP-ADDRESS
The IP address of the remote CICS.
PORT
The port number of the remote CICS that this IMS Connect instance communicates on.
HOSTNAME
The host name of the remote CICS or remote IMS Connect, if available.
NUMSOC
The number of sockets that are currently open.
SENDCLNT ISCNAME STATUS SECOND SENDPORT
If this instance of IMS Connect has one or more active connections to this remote CICS subsystem, the command output includes information about each connection. The information for an active connection is displayed immediately under the heading that describes the value.

The headings are described in the next list of fields.

SENDCLNT
The client ID that this instance of IMS Connect used to connect to the remote CICS.
ISCNAME
Name of the ISC configuration statement in the IMS Connect configuration member.
STATUS
State of this remote IMS Connect connection. Possible values include:
CONN
This connection is in connect state. It can send messages to the remote CICS.
RECV
This connection is in receive state. It is waiting to receive a response from the remote CICS.
SECOND
Number of seconds that this connection is in the specified state.
SENDPORT
The port that this instance of IMS Connect used to connect to the remote CICS.
RMTIMSCON=
Identifies a connection between this local IMS Connect instance and a remote instance of IMS Connect. The following additional output fields describe the status, attributes, and sockets that belong to the connection identified in the RMTIMSCON output field:
STATUS
The state of the connection displayed in the RMTIMSCON output field. A connection can be in the following states:
ACTIVE
This connection has at least one send socket open to a remote IMS Connect instance.
NOT ACTIVE
This connection does not have any send sockets open to a remote IMS Connect instance.
RETRY CONN
IMS Connect is attempting to automatically reconnect to the remote IMS Connect instance after a previous attempt to connect failed. If the current reconnection attempt fails, IMS Connect attempts to reconnect again every 2 minutes.

While a connection has a RETRY CONN status, the number of open sockets fluctuates. IMS Connect opens a socket when actively trying to reconnect. IMS Connect closes the socket during the 2-minute interval between reconnection attempts.

STOPPED
A STOPRMT command stopped communication on this connection. Any messages sent to this connection are rejected and an error is sent back to the sender.
IP-ADDRESS
The IP address of the IMS Connect instance at the remote end of this connection.
PORT
The port number used by the remote IMS Connect instance for this connection.
HOSTNAME
The host name of the remote IMS Connect instance, if available.
AUTOCONN
Indicates whether IMS Connect automatically establishes send sockets for OTMA communications on this connection during IMS Connect startup. Possible values are:
Y
Send sockets are automatically established on this connection when IMS Connect starts up. The number of sockets that IMS Connect establishes during startup is displayed in the RESVSOC output field
N
No sockets are established on this connection during IMS Connect startup. For OTMA messages, send sockets are established upon receipt of a message from OTMA for delivery to the remote IMS system.
PERSISTENT
Indicates whether the sockets on this connection are persistent.
Y
The sockets established on this connection are persistent.
N
The sockets established on this connection are not persistent. After messages are sent on this connection, the sockets that they are sent on are closed.
IDLETO
The time interval that open sockets on this connection can remain idle before they are closed by IMS Connect.
RESVSOC
The number of send sockets that are reserved for use by this connection.
NUMSOC
The number of sockets that are currently open on this connection.
SENDCLNT
The randomly generated send socket ID. The local instance of IMS Connect uses the ID to uniquely identify the socket. The send socket ID is used as the client ID when establishing a socket connection with the remote IMS Connect instance.

The send socket IDs that are used for OTMA begin with "OTM." The send socket IDs that are used for MSC begin with "MSC."

The values returned for this output field are displayed in tabular format.

If no sockets are currently open on this connection, this output field is not displayed.

LCLPLKID
The ID of a local MSC physical link that is using this connection. This value is specified on the LCLPLKID parameter of the MSC statement in the IMS Connect configuration member. The LCLPLKID output field is displayed only for connections that are used for MSC communications.

The values returned for this output field are displayed in tabular format.

If no sockets are currently open on this connection, this output field is not displayed.

USERID
The user ID provided by the local IMS system for transaction authorization by the remote IMS system. The USERID output field is displayed only for connections that are used for OTMA communications.

If no sockets are currently open on this connection, this output field is not displayed.

The values returned for this output field are displayed in tabular format.

STATUS
The current state of this socket connection. A socket connection can have the following states:
CONN
This socket connection can send messages to the remote IMS Connect.
RECV
This socket connection is waiting to receive a response from the remote IMS Connect.

The values returned for this output field are displayed in tabular format.

If no sockets are currently open on this connection, this output field is not displayed.

SECOND
The number of seconds that this connection has been in the state shown on the same row under the STATUS output field heading.

The values returned for this output field are displayed in tabular format.

If no sockets are currently open on this connection, this output field is not displayed.

SENDPORT
The local port used for this connection.

The values returned for this output field are displayed in tabular format.

If no sockets are currently open on this connection, this output field is not displayed.

PORT=
Identifies the port or ports to which the following output fields and statuses apply. The port numbers are defined in the IMS Connect configuration member in the IMS.PROCLIB data set.

You can determine the type of a port by the port-type indicator that is appended to the end of the port number. IMS Connect uses the following port-type indicators:

No type indicator
Indicates a port that can be used for IMS TM OTMA clients and IMS-to-IMS MSC or OTMA communications. Ports that do not have a type indicator are defined on either the PORT keyword or the PORTID keyword of the TCPIP statement in the IMS Connect configuration member.
C
Indicates an IBM® CICS® Transaction Server for z/OS port for ISC communications that is defined to IMS Connect on the CICSPORT parameter of the TCPIP and ISC statements. CICS ports are used exclusively by CICS subsystems that access IMS TM via an ISC TCP/IP link.
D
Indicates a Distributed Relational Database Architecture™ (DRDA) port that is defined to IMS Connect on the DRDAPORT parameter. DRDA ports are used exclusively by client application programs that access IMS DB through the Open Database Manager (ODBM).
S
Indicates an SSL port that is defined to IMS Connect on the SSLPORT parameter. SSL ports are used only when IMS Connect support for SSL is enabled.

The following output fields apply to the port identified in the preceding PORT output field.

STATUS
State of the port, whether ACTIVE or INACTIVE.
KEEPAV
The amount of time a connection remains idle before the z/OS TCP/IP layer sends a packet to maintain the connection.
NUMSOC
The number of sockets used on each port.
TIMEOUT
The amount of time IMS Connect waits before terminating a client connection if no messages are received from the client.
CLIENTID ISCNAME STATUS SECOND CLNTPORT IP-ADDRESS
or
CLIENTID LCLPLKID STATUS SECOND CLNTPORT IP-ADDRESS
or
CLIENTID USERID TRANCODE DATASTORE   STATUS SECOND CLNTPORT IP-ADDRESS APSB-TOKEN
The ID and information for an active client on a receive socket.

The information for each active client is displayed on a single row. Clients are grouped together by client type under a row of headings that identify the information that is returned for that client type.

For ISC clients, the following information is displayed: CLIENTID ISCNAME STATUS SECOND CLNTPORT IP-ADDRESS.

For MSC clients, the following information is displayed: CLIENTID LCLPLKID STATUS SECOND CLNTPORT IP-ADDRESS.

For OTMA and ODBM clients, the following information is displayed: CLIENTID USERID TRANCODE DATASTORE   STATUS SECOND CLNTPORT IP-ADDRESS APSB-TOKEN.

The following example shows the information returned for three OTMA clients:
HWSC0001I  PORT=9999     STATUS=ACTIVE     KEEPAV=0 NUMSOC=4 EDIT=         TIMEOUT=0 
HWSC0001I    CLIENTID USERID   TRANCODE DATASTORE STATUS    SECOND  CLNTPORT IP-ADDRESS       APSB-TOKEN
HWSC0001I    CLIENT63 USRT003  apol12   IMSY      RECV WFCM     55      4118 192.0.2.0        
HWSC0001I    CLIENT62 USRT002           IMS1      CONN         210      4115 192.0.2.0        
HWSC0001I    CLIENT61 USRT001  apol12   IMSN      RECV          13      4112 192.0.2.0        
HWSC0001I    TOTAL CLIENTS=3  RECV=2 CONN=1 XMIT=0 OTHER=0

If a port has no active clients on it, these output fields are not displayed. Instead, the command output displays NO ACTIVE CLIENTS after the row that identifies the port.

The information returned for active clients includes, in alphabetical order:

APSB-TOKEN
Open Database Manager (ODBM) APSB token.
CLIENTID
The name of the client.

For connections from other IMS Connect instances, the other IMS Connect instance generates this value.

CLNTPORT
A random number that TCP/IP generates to represent a connection from a client.
DATASTORE
The data store associated with this client.
The IP address of the client for this connection.

If IPV6 is enabled, the IP address format consists of eight hexadecimal numbers divided by colons. If IPV6 is not enabled, the IP address format of IPV4 is used. The following example is for an IPV6 IP address that is displayed in IPV6 format:

FEDC:ABCD:2222:3333:FEDC:DB55:6666:3322
The following example is for an IPV4 IP address that is displayed in IPV6 format: 
0:0:0:0:0:FFFF:945:33FF
ISCNAME
The name of the ISC statement in the IMS Connect configuration member.
LCLPLKID
The MSC physical link in the local IMS system to which IMS Connect routes the messages from the client. This field exists only for MSC communications.
SECOND
Number of seconds that the client has been in the specified status.
STATUS
State of the thread of the client. The client thread state can be one of the following values:
RECV
In a receive state waiting for input from client.
READ
In a partial read state. IMS Connect is reading a message from the client but has not yet received the entire length of the message.
CONN
Waiting for output from IMS.
XMIT
Sending data to client.
CONV
In a conversational state.
WFCM
Waiting for confirmation (ACK, NAK, or DEALLOCATE) from client.
TRANCODE
The transaction code submitted by the client.
USERID
The USERID name passed to IMS Connect.

Example 1: VIEWHWS command

In the following example, nn is the 2-digit number of the z/OS system console outstanding display.

To view the information for an instance of IMS Connect:

   nnVIEWHWS

This command produces the following output:

HWSC0001I HWS ID=HWS1     RACF=N  PSWDMC=N
HWSC0001I    UIDCACHE=Y   UIDAGE=2147483647    
HWSC0001I    MAXSOC=2000  TIMEOUT=5000 TCPIPQ=50
HWSC0001I    NUMSOC=7     WARNSOC=80%  WARNINC=5%
Start of changeHWSC0001I    RRS=Y  STATUS=REGISTERED  MULTIRTP=  CASCADE=NEnd of change
HWSC0001I    VERSION=V14 IP-ADDRESS=127.0.0.1      
HWSC0001I    SUPER MEMBER NAME=SM01  CM0 ACK TOQ=

HWSC0001I   ADAPTER=N    MAXCVRT=100  NUMCVRT=0
HWSC0001I    MAXLSSSZ=32767
HWSC0001I  ODBM AUTO CONNECTION=Y
HWSC0001I  ODBM TIMEOUT=18000
HWSC0001I  ODBM IMSPLEX MEMBER=IMSPLEX1 TARGET MEMBER=PLEX1 
HWSC0001I  DATASTORE=IMS1     STATUS=ACTIVE
HWSC0001I    GROUP=XCFGRP1  MEMBER=HWS1
HWSC0001I    TARGET MEMBER=IMS1           STATE=AVAIL
HWSC0001I    DEFAULT REROUTE NAME=CFG$DEF
Start of changeHWSC0001I    RACF APPL NAME=APPLID1       MULTIRTP=  CASCADE=YEnd of change
HWSC0001I    OTMA ACEE AGING VALUE=2147483647
HWSC0001I    OTMA ACK TIMEOUT VALUE=120
HWSC0001I    OTMA MAX INPUT MESSAGE=5000
HWSC0001I    SUPER MEMBER NAME=SM01  CM0 ACK TOQ=
Start of changeHWSC0001I      STATUS=ACTIVEEnd of change
HWSC0001I    MEMBER=IMSPLEX1 TARGET=PLEX1
HWSC0001I  ODBM=ODBMAOD  STATUS=REGISTERED   ODBMRRS=Y
HWSC0001I    ALIAS=IMS1  STATUS=ACTIVE, TRACE
HWSC0001I    ALIAS=IMS2  STATUS=NOT ACTIVE
HWSC0001I  ODBM=ODBMBOD  STATUS=REGISTERED ODBMRRS=N
HWSC0001I    ALIAS=IMS1  STATUS=ACTIVE
HWSC0001I    ALIAS=IMS2  STATUS=ACTIVE 
HWSC0001I  ODBM=ODBMCOD  STATUS=NOT ACTIVE
HWSC0001I  ODBM=ODBMDOD  STATUS=NOT ACTIVE
HWSC0001I  PORT=9999     STATUS=ACTIVE     KEEPAV=0 NUMSOC=4 EDIT=         TIMEOUT=0 
HWSC0001I    CLIENTID USERID   TRANCODE DATASTORE STATUS    SECOND  CLNTPORT IP-ADDRESS       APSB-TOKEN
HWSC0001I    CLIENT63 USRT003  apol12   IMSY      RECV WFCM     55      4118 192.0.2.0        
HWSC0001I    CLIENT62 USRT002           IMS1      CONN         210      4115 192.0.2.0        
HWSC0001I    CLIENT61 USRT001  apol12   IMSN      RECV          13      4112 192.0.2.0        
HWSC0001I    TOTAL CLIENTS=3  RECV=2 CONN=1 XMIT=0 OTHER=0             
HWSC0001I  PORT=LOCAL    STATUS=ACTIVE     KEEPAV=0 NUMSOC=0 EDIT=         TIMEOUT=0  
HWSC0001I    NO ACTIVE CLIENTS
HWSC0001I  PORT=9998S    STATUS=NOT ACTIVE KEEPAV=0 NUMSOC=1 EDIT=         TIMEOUT=0
HWSC0001I  PORT=1111D    STATUS=ACTIVE     KEEPAV=5 NUMSOC=1 EDIT=         TIMEOUT=6000
HWSC0001I    NO ACTIVE CLIENTS
HWSC0001I  PORT=2222D    STATUS=ACTIVE     KEEPAV=0 NUMSOC=1 EDIT=         TIMEOUT=100
HWSC0001I    NO ACTIVE CLIENTS

Example 2: SUMMARY

In the following example, nn is the 2-digit number of the z/OS system console outstanding display.

To view the summary information for an instance of IMS Connect:

   nnVIEWHWS SUMMARY

This command produces the same output as the VIEWHWS command without the SUMMARY keyword except for the PORT= sections, which give only the total counts for the ports, eliminating individual client displays.

HWSC0001I HWS ID=HWS1     RACF=N  PSWDMC=N
HWSC0001I    UIDCACHE=Y   UIDAGE=2147483647    
HWSC0001I    MAXSOC=50    TIMEOUT=5000 TCPIPQ=50
HWSC0001I    NUMSOC=7     WARNSOC=80%  WARNINC=5%
Start of changeHWSC0001I    RRS=Y   STATUS=REGISTERED MULTIRTP=  CASCADE=YEnd of change
HWSC0001I    VERSION=V14 IP-ADDRESS=127.0.0.1      
HWSC0001I    SUPER MEMBER NAME=SM01  CM0 ACK TOQ=

HWSC0001I   ADAPTER=N    MAXCVRT=100  NUMCVRT=0
HWSC0001I    MAXLSSSZ=32767
HWSC0001I  ODBM AUTO CONNECTION=Y
HWSC0001I  ODBM TIMEOUT=18000
HWSC0001I  ODBM IMSPLEX MEMBER=IMSPLEX1 TARGET MEMBER=PLEX1 
HWSC0001I  DATASTORE=IMS1     STATUS=ACTIVE
HWSC0001I    GROUP=XCFGRP1  MEMBER=HWS1
HWSC0001I    TARGET MEMBER=IMS1           STATE=AVAIL
HWSC0001I    DEFAULT REROUTE NAME=CFG$DEF
Start of changeHWSC0001I    RACF APPL NAME=APPLID1       MULTIRTP=  CASCADE=End of change
HWSC0001I    OTMA ACEE AGING VALUE=2147483647
HWSC0001I    OTMA ACK TIMEOUT VALUE=120
HWSC0001I    OTMA MAX INPUT MESSAGE=5000
HWSC0001I    SUPER MEMBER NAME=SM01  CM0 ACK TOQ=
Start of changeHWSC0001I  IMSPLEX=PLEX1    STATUS=ACTIVEEnd of change
HWSC0001I    MEMBER=IMSPLEX1 TARGET=PLEX1
HWSC0001I  ODBM=ODBMAOD  STATUS=REGISTERED   ODBMRRS=Y
HWSC0001I    ALIAS=IMS1  STATUS=ACTIVE, TRACE
HWSC0001I    ALIAS=IMS2  STATUS=NOT ACTIVE(IMSCON,ODBM)
HWSC0001I  ODBM=ODBMBOD  STATUS=REGISTERED ODBMRRS=N
HWSC0001I    ALIAS=IMS1  STATUS=ACTIVE
HWSC0001I    ALIAS=IMS2  STATUS=ACTIVE 
HWSC0001I  ODBM=ODBMCOD  STATUS=NOT ACTIVE
HWSC0001I  ODBM=ODBMDOD  STATUS=NOT ACTIVE
HWSC0001I  PORT=9999     STATUS=ACTIVE     KEEPAV=0 NUMSOC=4 EDIT=         TIMEOUT=0 
HWSC0001I    TOTAL CLIENTS=3  RECV=2 CONN=1 XMIT=0 OTHER=0             
HWSC0001I  PORT=LOCAL    STATUS=ACTIVE     KEEPAV=0 NUMSOC=0 EDIT=         TIMEOUT=0  
HWSC0001I    NO ACTIVE CLIENTS
HWSC0001I  PORT=9998S    STATUS=NOT ACTIVE KEEPAV=0 NUMSOC=1 EDIT=         TIMEOUT=0
HWSC0001I  PORT=1111D    STATUS=ACTIVE     KEEPAV=5 NUMSOC=1 EDIT=         TIMEOUT=6000
HWSC0001I    NO ACTIVE CLIENTS
HWSC0001I  PORT=2222D    STATUS=ACTIVE     KEEPAV=0 NUMSOC=1 EDIT=         TIMEOUT=100
HWSC0001I    NO ACTIVE CLIENTS

Example 3: IMS Connect to IMS Connect connections for MSC

If connections between IMS Connect instances are used for MSC, the command output presents different perspectives of the connections, depending on which instance of IMS Connect the command is issued against.

For MSC communications, one instance of IMS Connect has a connection defined to send MSC messages to the other instance of IMS Connect. The other instance of IMS Connect has a connection defined to send the reply messages.

In the following example output, the command was issued for an IMS Connect instance, HWS1, at the IMS installation where the MSC transactions are input to IMS. HWS1 is connected to another IMS Connect instance, HWS2. HWS1 knows HWS2 only by the RMTIMSCON name ICON2. HWS1 has two active client connections for sending MSC transactions to ICON2 for processing, MSCBB435 and MSC84CF7, shown under SENDCLNT in the RMTIMSCON information. HWS1 receives the response messages to the MSC transactions on the client connections MSCC73E0 and MSC0EBB0, shown under CLIENTID in the PORT information.

A DATASTORE statement is defined for this instance of IMS Connect; however, DATASTORE statements are not used for MSC communications and can be omitted if your instance of IMS Connect does not communicate with OTMA.

HWSC0001I   HWS ID=HWS1     RACF=N  PSWDMC=R                            
HWSC0001I      UIDCACHE=N   UIDAGE=2147483647                           
HWSC0001I      MAXSOC=2000  TIMEOUT=5000 TCPIPQ=50                      
HWSC0001I      NUMSOC=5     WARNSOC=80%  WARNINC=5%                     
Start of changeHWSC0001I      RRS=N   STATUS=REGISTERED MULTIRTP=  CASCADE=NEnd of change
HWSC0001I      VERSION=V14 IP-ADDRESS=192.0.2.0                         
HWSC0001I      SUPER MEMBER NAME=      CM0 ACK TOQ=                     

HWSC0001I     ADAPTER=N   MAXCVRT=100  NUMCVRT=0                        
HWSC0001I      MAXLSSSZ=32767
HWSC0001I    DATASTORE=IMS1     STATUS=DISCONNECT                       
HWSC0001I      GROUP=XCFGRP1  MEMBER=HWS1                               
HWSC0001I      TARGET MEMBER=IMS1             STATE=N/A                 
HWSC0001I      DEFAULT REROUTE NAME=HWS$DEF                             
Start of changeHWSC0001I      RACF APPL NAME=APPLID1         MULTIRTP=  CASCADE=End of change
HWSC0001I      OTMA ACEE AGING VALUE=2147483647                         
HWSC0001I      OTMA ACK TIMEOUT VALUE=120                               
HWSC0001I      OTMA MAX INPUT MESSAGE=5000                              
HWSC0001I      SUPER MEMBER NAME=      CM0 ACK TOQ=                     
Start of changeHWSC0001I    IMSPLEX=PLEX1    STATUS=ACTIVEEnd of change
HWSC0001I      MEMBER=HWS1     TARGET=PLEX1                             
HWSC0001I    MSC=MSC12    STATUS=ACTIVE                                 
HWSC0001I      RMTPLKID=MSC21                                           
HWSC0001I      LCLIMSID=IMS1      RMTIMSID=IMS2                         
HWSC0001I      IMSPLEX=PLEX1                                            
HWSC0001I        MEMBER=HWS1              TARGET MEMBER=PLEX1           
HWSC0001I      RMTIMSCON=ICON2                                          
HWSC0001I        IP-ADDRESS=127.0.0.1        PORT=5555                  
HWSC0001I        HOSTNAME=WWW.EXAMPLE.COM                      
HWSC0001I      LINK       PARTNERID   STATUS       SENDCLNT   RECVCLNT  
HWSC0001I      LNK12T01   TA          ACTIVE       MSC84CF7   MSC0EBB0  
HWSC0001I      LNK12T02   TB          ACTIVE       MSCBB435   MSCC73E0  
HWSC0001I    NO ACTIVE ODBM                                             
HWSC0001I    PORT=9999     STATUS=ACTIVE     KEEPAV=0 NUMSOC=3      EDIT=     TIMEOUT=0
HWSC0001I      CLIENTID LCLPLKID  STATUS      SECOND CLNTPORT IP-ADDRESS
HWSC0001I      MSCC73E0 MSC12     RECV             6 1026     0:0:0:0:0:FFFF:7F00:1
HWSC0001I      MSC0EBB0 MSC12     RECV            56 1025     0:0:0:0:0:FFFF:7F00:1
HWSC0001I      TOTAL CLIENTS=2  RECV=2 READ=0 CONN=0 XMIT=0 OTHER=0     
HWSC0001I    RMTIMSCON=ICON2     STATUS=ACTIVE                          
HWSC0001I      IP-ADDRESS=127.0.0.1        PORT=5555                    
HWSC0001I      HOSTNAME=WWW.EXAMPLE.COM                        
HWSC0001I      AUTOCONN=N  PERSISTENT=Y                                 
HWSC0001I      IDLETO=0                                                 
HWSC0001I      RESVSOC=2   NUMSOC=2                                     
HWSC0001I      SENDCLNT LCLPLKID STATUS       SECOND SENDPORT           
HWSC0001I      MSCBB435 MSC12    CONN              6 1028               
HWSC0001I      MSC84CF7 MSC12    CONN             56 1027               
HWSC0001I      TOTAL SENDCLNTS=2 RECV=0 CONN=2 XMIT=0 OTHER=0

The following example output corresponds to the preceding example output, and was produced by executing the command on IMS Connect instance HWS2, at the remote IMS installation where the MSC transactions are processed. HWS2 knows HWS1 only by the RMTIMSCON name ICON1. HWS2 receives MSC transactions on two active client connections, MSCBB435 and MSC84CF7, shown in the PORT information under CLIENTID. These IDs are the same IDs shown in the HWS1 example under SENDCLNT. After processing the MSC transactions, HWS2 sends the response messages back to ICON1 on the two active client connections shown under SENDCLNT in the RMTIMSCON information: MSCC73E0 and MSC0EBB0, the same IDs shown in the HWS1 example under CLIENTID.

HWSC0001I   HWS ID=HWS2     RACF=N  PSWDMC=R                            
HWSC0001I      UIDCACHE=N   UIDAGE=2147483647                           
HWSC0001I      MAXSOC=50  TIMEOUT=5000    TCPIPQ=50                     
HWSC0001I      NUMSOC=5      WARNSOC=80%  WARNINC=5%                    
Start of changeHWSC0001I      RRS=N   STATUS=REGISTERED  MULTIRTP=  CASCADE=NEnd of change
HWSC0001I      VERSION=V14 IP-ADDRESS=127.0.0.1                         
HWSC0001I      SUPER MEMBER NAME=      CM0 ACK TOQ=                     

HWSC0001I    ADAPTER=N     MAXCVRT=100   NUMCVRT=0                      
HWSC0001I      MAXLSSSZ=32767
HWSC0001I    DATASTORE=IMS2     STATUS=DISCONNECT                       
HWSC0001I      GROUP=XCFGRP1  MEMBER=HWS2                               
HWSC0001I      TARGET MEMBER=IMS2             STATE=N/A                 
HWSC0001I      DEFAULT REROUTE NAME=HWS$DEF                             
Start of changeHWSC0001I      RACF APPL NAME=APPLID1         MULTIRTP=  CASCADE=End of change
HWSC0001I      OTMA ACEE AGING VALUE=2147483647                         
HWSC0001I      OTMA ACK TIMEOUT VALUE=120                               
HWSC0001I      OTMA MAX INPUT MESSAGE=5000                              
HWSC0001I      SUPER MEMBER NAME=      CM0 ACK TOQ=                     
Start of changeHWSC0001I    IMSPLEX=PLEX2    STATUS=ACTIVEEnd of change
HWSC0001I      MEMBER=HWS2     TARGET=PLEX2                             
HWSC0001I    MSC=MSC21    STATUS=ACTIVE                                 
HWSC0001I      RMTPLKID=MSC12                                           
HWSC0001I      LCLIMSID=IMS2      RMTIMSID=IMS1                         
HWSC0001I      IMSPLEX=PLEX2                                            
HWSC0001I        MEMBER=HWS2              TARGET MEMBER=PLEX2           
HWSC0001I      RMTIMSCON=ICON1                                          
HWSC0001I        IP-ADDRESS=192.0.2.0        PORT=9999                  
HWSC0001I        HOSTNAME=WWW.EXAMPLE.COM                      
HWSC0001I      LINK       PARTNERID   STATUS       SENDCLNT   RECVCLNT  
HWSC0001I      LNK21T01   TA          ACTIVE       MSC0EBB0   MSC84CF7  
HWSC0001I      LNK21T02   TB          ACTIVE       MSCC73E0   MSCBB435  
HWSC0001I    NO ACTIVE ODBM                                             
HWSC0001I    PORT=5555     STATUS=ACTIVE     KEEPAV=0 NUMSOC=3     EDIT=      TIMEOUT=0
HWSC0001I      CLIENTID LCLPLKID  STATUS      SECOND CLNTPORT IP-ADDRESS
HWSC0001I      MSCBB435 MSC21     RECV            18 1028     0:0:0:0:0:FFFF:C000:200
HWSC0001I      MSC84CF7 MSC21     RECV            69 1027     0:0:0:0:0:FFFF:C000:200
HWSC0001I      TOTAL CLIENTS=2  RECV=2 READ=0 CONN=0 XMIT=0 OTHER=0     
HWSC0001I    RMTIMSCON=ICON1     STATUS=ACTIVE                          
HWSC0001I      IP-ADDRESS=192.0.2.0        PORT=9999                    
HWSC0001I      HOSTNAME=WWW.EXAMPLE.COM                        
HWSC0001I      AUTOCONN=N  PERSISTENT=Y                                 
HWSC0001I      IDLETO=0                                                 
HWSC0001I      RESVSOC=2   NUMSOC=2                                     
HWSC0001I      SENDCLNT LCLPLKID STATUS       SECOND SENDPORT           
HWSC0001I      MSCC73E0 MSC21    CONN             18 1026               
HWSC0001I      MSC0EBB0 MSC21    CONN             69 1025               
HWSC0001I      TOTAL SENDCLNTS=2 RECV=0 CONN=2 XMIT=0 OTHER=0

Example 4: IMS Connect to IMS Connect connections for OTMA

If a connection between IMS Connect instances is used for OTMA messages, the command output shows different perspectives of the connection, depending on which instance of IMS Connect the command is executed on.

For OTMA, because the connections between IMS Connect instances are one-way connections, the connection is defined only in the sending IMS Connect instance. The connection is not defined in the remote IMS Connect instance.

In the following example output, the command is executed on HWS1, the IMS Connect instance at the IMS installation that sends the OTMA output messages. HWS1 is connected to a receiving IMS Connect instance, HWS2; however, HWS1 knows HWS2 only by the RMTIMSCON name ICON2B shown in the example. HWS1 sends the OTMA output messages to ICON2 for processing on the active client connection, OTM924FA, shown under SENDCLNT in the RMTIMSCON information. The SENDCLNT ID is auto-generated by HWS1 when establishing the connection with HWS2.

HWSC0001I   HWS ID=HWS1     RACF=N  PSWDMC=R                          
HWSC0001I      UIDCACHE=N   UIDAGE=2147483647                         
HWSC0001I      MAXSOC=2000  TIMEOUT=5000  TCPIPQ=50                   
HWSC0001I      NUMSOC=2      WARNSOC=80%  WARNINC=5%                  
Start of changeHWSC0001I      RRS=N   STATUS=REGISTERED  MULTIRTP=  CASCADE=NEnd of change
HWSC0001I      VERSION=V14 IP-ADDRESS=192.0.2.0                       
HWSC0001I      SUPER MEMBER NAME=      CM0 ACK TOQ=                   
HWSC0001I    ADAPTER=N  MAXCVRT=100  NUMCVRT=0                        
HWSC0001I      MAXLSSSZ=32767
HWSC0001I    DATASTORE=IMS1     STATUS=ACTIVE                         
HWSC0001I      GROUP=XCFGRP1  MEMBER=HWS1                             
HWSC0001I      TARGET MEMBER=IMS1             STATE=AVAIL             
HWSC0001I      DEFAULT REROUTE NAME=HWS$DEF                           
Start of changeHWSC0001I      RACF APPL NAME=APPLID1         MULTIRTP=  CASCADE=End of change
HWSC0001I      OTMA ACEE AGING VALUE=2147483647                       
HWSC0001I      OTMA ACK TIMEOUT VALUE=120                             
HWSC0001I      OTMA MAX INPUT MESSAGE=5000                            
HWSC0001I      SUPER MEMBER NAME=      CM0 ACK TOQ=                   
HWSC0001I    NO ACTIVE IMSPLEX                                        
HWSC0001I    NO ACTIVE ODBM                                           
HWSC0001I    NO ACTIVE MSC                                            
HWSC0001I    PORT=9999     STATUS=ACTIVE     KEEPAV=0 NUMSOC=1     EDIT=     TIMEOUT=0
HWSC0001I      NO ACTIVE CLIENTS                                      
HWSC0001I    RMTIMSCON=ICON2B    STATUS=ACTIVE                        
HWSC0001I      IP-ADDRESS=127.0.0.1        PORT=5555                  
HWSC0001I      HOSTNAME=WWW.EXAMPLE.COM                      
HWSC0001I      AUTOCONN=N  PERSISTENT=Y                               
HWSC0001I      IDLETO=3000                                            
HWSC0001I      RESVSOC=4   NUMSOC=1                                   
HWSC0001I      SENDCLNT USERID   STATUS       SECOND SENDPORT         
HWSC0001I      OTM924FA APOL1    CONN           5941 1026             
HWSC0001I      TOTAL SENDCLNTS=1 RECV=0 CONN=1 XMIT=0 OTHER=0

The following example output corresponds to the preceding example output, and was produced by executing the command on HWS2, the IMS Connect instance at the IMS installation that receives the OTMA output messages. HWS2 knows HWS1 only by the auto-generated client ID, OTM924FA, shown under CLIENTID in the PORT information. The CLIENTID value is the same value shown under SENDCLNT at the local IMS installation. HWS2 receives the OTMA transactions on the connection identified by the client ID OTM924FA. After processing the OTMA message, the remote IMS system queues any response messages to the tpipe hold queue identified by the client ID OTM924FA for later asynchronous retrieval.

HWSC0001I   HWS ID=HWS2     RACF=N  PSWDMC=R                           
HWSC0001I      UIDCACHE=N   UIDAGE=2147483647                          
HWSC0001I      MAXSOC=50  TIMEOUT=5000  TCPIPQ=50                      
HWSC0001I      NUMSOC=5      WARNSOC=80%  WARNINC=5%                   
Start of changeHWSC0001I      RRS=N   STATUS=REGISTERED  MULTIRTP=  CASCADE=NEnd of change
HWSC0001I      VERSION=V14 IP-ADDRESS=127.0.0.1                        
HWSC0001I      SUPER MEMBER NAME=      CM0 ACK TOQ=                    
HWSC0001I    ADAPTER=N  MAXCVRT=100  NUMCVRT=0                         
HWSC0001I      MAXLSSSZ=32767
HWSC0001I    DATASTORE=IMS2     STATUS=ACTIVE                          
HWSC0001I      GROUP=XCFGRP2  MEMBER=HWS2                              
HWSC0001I      TARGET MEMBER=IMS2             STATE=AVAIL              
HWSC0001I      DEFAULT REROUTE NAME=HWS$DEF                            
Start of changeHWSC0001I      RACF APPL NAME=APPLID1         MULTIRTP=  CASCADE=End of change
HWSC0001I      OTMA ACEE AGING VALUE=2147483647                        
HWSC0001I      OTMA ACK TIMEOUT VALUE=120                              
HWSC0001I      OTMA MAX INPUT MESSAGE=5000                             
HWSC0001I      SUPER MEMBER NAME=      CM0 ACK TOQ=                    
HWSC0001I    NO ACTIVE IMSPLEX                                         
HWSC0001I    NO ACTIVE ODBM                                            
HWSC0001I    NO ACTIVE MSC                                             
HWSC0001I    PORT=9999     STATUS=ACTIVE     KEEPAV=0 NUMSOC=1         EDIT=         TIMEOUT=0
HWSC0001I      NO ACTIVE CLIENTS                                       
HWSC0001I    PORT=8888     STATUS=ACTIVE     KEEPAV=0 NUMSOC=1         EDIT=         TIMEOUT=0
HWSC0001I      NO ACTIVE CLIENTS                                       
HWSC0001I    PORT=7777     STATUS=ACTIVE     KEEPAV=0 NUMSOC=1         EDIT=         TIMEOUT=0
HWSC0001I      NO ACTIVE CLIENTS                                       
HWSC0001I    PORT=5555     STATUS=ACTIVE     KEEPAV=0 NUMSOC=2         EDIT=         TIMEOUT=0
HWSC0001I      CLIENTID USERID TRANCODE DATASTORE STATUS SECOND CLNTPORT IP-ADDRESS              APSB-TOKEN
HWSC0001I      OTM924FA APOL1  APOL11   IMS2      RECV       11 1026     0:0:0:0:0:FFFF:C000:200
HWSC0001I      TOTAL CLIENTS=1  RECV=1 READ=0 CONN=0 XMIT=0 OTHER=0    
HWSC0001I    RMTIMSCON=ICON1B    STATUS=NOT ACTIVE                     
HWSC0001I      IP-ADDRESS=192.0.2.0        PORT=9999                   
HWSC0001I      HOSTNAME=WWW.EXAMPLE.COM                       
HWSC0001I      AUTOCONN=N  PERSISTENT=Y                                
HWSC0001I      IDLETO=0                                                
HWSC0001I      RESVSOC=4   NUMSOC=0                                    
HWSC0001I      NO ACTIVE CLIENTS
Start of change

Example 5: ISC connections between IMS Connect and CICS

In the following example output, an ISC link, IMS1CIC4, links to a remote CICS subsystem by way of the RMTCICS connection, CICS4.

Currently, three parallel sessions, or ISCUSERs, are active: CIC4U01, CIC4U02, and CIC4U03. The status, the send client ID, and the receive client ID are shown on the row for each parallel session.

IMS Connect receives input messages from CICS on port 9876C, as defined by the CICSPORT keyword in the IMS Connect configuration member. Each receive socket for each parallel session on the CICSPORT is identified by a receive client ID that is generated by IMS Connect.

IMS Connect sends output messages to CICS through send sockets on ports that are automatically selected by IMS Connect. Each send socket for each parallel session is identified by a send client ID that is automatically generated by IMS Connect.

HWSC0001I HWS ID=HWS1     RACF=N  PSWDMC=R         
HWSC0001I    UIDCACHE=N   UIDAGE=2147483647        
HWSC0001I    MAXSOC=50  TIMEOUT=5000  TCPIPQ=50    
HWSC0001I    NUMSOC=7      WARNSOC=80%  WARNINC=5% 
Start of changeHWSC0001I    RRS=N   STATUS=NOT ACTIVE  MULTIRTP=  CASCADE=NEnd of change
Start of changeHWSC0001I    VERSION=V14 IP-ADDRESS=127.0.0.1     End of change
HWSC0001I    SUPER MEMBER NAME=      CM0 ACK TOQ=  

HWSC0001I ADAPTER=N MAXCVRT=100 NUMCVRT=0         
HWSC0001I    MAXLSSSZ=32767                        
HWSC0001I  IMSPLEX=PLEX1    STATUS=ACTIVE
HWSC0001I    MEMBER=HWS1     TARGET=PLEX1          
HWSC0001I  ISC=IMS1CIC4 STATUS=ACTIVE                      
HWSC0001I    NODE=CIC4                                     
HWSC0001I    LCLIMSID=IMS1                        
HWSC0001I    IMSPLEX=PLEX1                                 
HWSC0001I      MEMBER=HWS1              TARGET MEMBER=PLEX1
HWSC0001I    RMTCICS=CICS4                                 
HWSC0001I      IP-ADDRESS=192.0.2.0        PORT=7777       
HWSC0001I      HOSTNAME=WWW.EXAMPLE.COM            
HWSC0001I    CICSAPPL=CICS1     CICSPORT=9876              
HWSC0001I    CICSNETID=IMSNET                              
HWSC0001I    ISCUSER    STATUS       SENDCLNT   RECVCLNT   
HWSC0001I    CIC4U01    ACTIVE       ISCE7811   ISCF4816   
HWSC0001I    CIC4U02    ACTIVE       ISC3A819   ISC7121D   
HWSC0001I    CIC4U03    ACTIVE       ISCECD99   ISC5C09F   
HWSC0001I    TOTAL ISCUSERS=3 ACTIVE=3 OTHER=0             
HWSC0001I  NO ACTIVE ODBM                                  
HWSC0001I  NO ACTIVE MSC                                   
HWSC0001I  PORT=9876C    STATUS=ACTIVE     KEEPAV=0 NUMSOC=4 EDIT=         TIMEOUT=0
HWSC0001I    CLIENTID ISCNAME   STATUS      SECOND CLNTPORT IP-ADDRESS
HWSC0001I    ISC5C09F IMS1CIC4  RECV             4 1037     0:0:0:0:0:FFFF:C000:200
HWSC0001I    ISC7121D IMS1CIC4  RECV            13 1035     0:0:0:0:0:FFFF:C000:200
HWSC0001I    ISCF4816 IMS1CIC4  RECV           200 1033     0:0:0:0:0:FFFF:C000:200
HWSC0001I    TOTAL CLIENTS=3  RECV=3 READ=0 CONN=0 XMIT=0 OTHER=0     
HWSC0001I  NO ACTIVE RMTIMSCON                                        
HWSC0001I  RMTCICS=CICS4     STATUS=ACTIVE                            
HWSC0001I    IP-ADDRESS=192.0.2.0      PORT=7777                    
HWSC0001I    HOSTNAME=WWW.EXAMPLE.COM                         
HWSC0001I    SENDCLNT ISCNAME  STATUS       SECOND SENDPORT           
HWSC0001I    ISCECD99 IMS1CIC4 CONN              4 1036               
HWSC0001I    ISC3A819 IMS1CIC4 CONN             13 1034    
HWSC0001I    ISCE7811 IMS1CIC4 CONN            200 1032    
HWSC0001I    TOTAL SENDCLNTS=3 RECV=0 CONN=3 XMIT=0 OTHER=0
End of change

Example 6: Multiple client types

In the following example output, IMS Connect supports many different client types, including:
  • Clients that connect to IMS DB via a DRDA port and the Open Database Manager (ODBM) component of the IMS Common Service Layer (CSL).
  • Clients that connect to IMS TM via a DATASTORE connection and the IMS Open Transaction Manager Access (OTMA) component.
  • A CICS system that connects to IMS TM via ISC and the CICS IPIC protocol
  • An IMS system that connects to another IMS system via OTMA
  • An IMS system that connects in another IMS system via MSC

Certain output fields are always displayed while other output fields are displayed only if IMS Connect is actively supporting a specific client type.

HWSC0001I   HWS ID=ICON1    RACF=N  PSWDMC=R                    
HWSC0001I      MAXSOC=50  TIMEOUT=5000  TCPIPQ=50               
HWSC0001I      NUMSOC=18     WARNSOC=80%  WARNINC=5%            
Start of changeHWSC0001I      RRS=N   STATUS=ACTIVE      MULTIRTP=  CASCADE=NEnd of change
Start of changeHWSC0001I      VERSION=V14 IP-ADDRESS=127.0.0.1     End of change
HWSC0001I      SUPER MEMBER NAME=      CM0 ACK TOQ=             

HWSC0001I    ADAPTER=Y  MAXCVRT=100  NUMCVRT=0                  
HWSC0001I      MAXLSSSZ=32767                                   
HWSC0001I    ODBM AUTO CONNECTION=Y                             
HWSC0001I    ODBM TIMEOUT=1200000                               
HWSC0001I    ODBM IMSPLEX MEMBER=                 TARGET MEMBER=
HWSC0001I    DATASTORE=IMS1     STATUS=ACTIVE               
HWSC0001I      GROUP=XCFGRP1  MEMBER=ICON1                      
HWSC0001I      TARGET MEMBER=IMS1             STATE=N/A         
HWSC0001I      DEFAULT REROUTE NAME=THATWAY                     
Start of changeHWSC0001I      RACF APPL NAME=APPLID1         MULTIRTP=  CASCADE=End of change
HWSC0001I      OTMA ACEE AGING VALUE=2147483647                 
HWSC0001I      OTMA ACK TIMEOUT VALUE=120                       
HWSC0001I      OTMA MAX INPUT MESSAGE=5000                      
HWSC0001I      SUPER MEMBER NAME=      CM0 ACK TOQ=             
HWSC0001I    IMSPLEX=PLEX1    STATUS=ACTIVE
HWSC0001I      MEMBER=ICON1    TARGET=PLEX1                     
HWSC0001I    ODBM=ODBM1OD  STATUS=REGISTERED   ODBMRRS=Y        
HWSC0001I      ALIAS=ALI1     STATUS=ACTIVE                     
HWSC0001I      ALIAS=IMSA     STATUS=ACTIVE                     
HWSC0001I      ALIAS=IMS1     STATUS=ACTIVE                     
HWSC0001I      ALIAS=ALI2     STATUS=ACTIVE                     
HWSC0001I      ALIAS=IMS2     STATUS=ACTIVE                     
HWSC0001I    MSC=MSC12    STATUS=ACTIVE
HWSC0001I      RMTPLKID=MSC21
HWSC0001I      LCLIMS=IMS1 RMTIMS=IMS2 GENIMSID=IMS AFFINTY=IMS1
HWSC0001I      IMSPLEX=PLEX1
HWSC0001I        MEMBER=ICON1    TARGET MEMBER=PLEX1
HWSC0001I      RMTIMSCON=CONNECT2
HWSC0001I        IP-ADDRESS=192.0.2.0      PORT=5555
HWSC0001I        HOSTNAME=WWW.EXAMPLE.COM
HWSC0001I      LINK     PARTNERID STATUS     SENDCLNT RECVCLNT
HWSC0001I      LINK12A  AA        ACTIVE     MSC11111 MSC33333
HWSC0001I      LINK12B  BB        ACTIVE     MSC22222 MSC44444  
HWSC0001I    ISC=CICS    STATUS=ACTIVE                            
HWSC0001I      NODE=CICSTRM1                                      
HWSC0001I      LCLIMSID=IMS1      
HWSC0001I      IMSPLEX=PLEX1                                            
HWSC0001I        MEMBER=HWS1              TARGET MEMBER=PLEX1           
HWSC0001I      RMTCICS=ICONNT1                                        
HWSC0001I        IP-ADDRESS=192.0.2.1        PORT=9999                  
HWSC0001I        HOSTNAME=WWW.EXAMPLE.COM    
HWSC0001I        CICSAPPL=CICSA1   CICSPORT=6666
HWSC0001I        CICSNETID=CICSNET
HWSC0001I      NO ACTIVE ISCUSER 
HWSC0001I    ISC=LU6TCP2    STATUS=ACTIVE                             
HWSC0001I      NODE=CICSTRM2                                         
HWSC0001I      LCLIMSID=IMS1            
HWSC0001I      IMSPLEX=PLEX1                                            
HWSC0001I        MEMBER=HWS1              TARGET MEMBER=PLEX1           
HWSC0001I      RMTCICS=ICONNT2                                        
HWSC0001I        IP-ADDRESS=192.0.2.2        PORT=9998                  
HWSC0001I        HOSTNAME=WWW.EXAMPLE.COM 
HWSC0001I        CICSAPPL=CICSA2   CICSPORT=7777
HWSC0001I        CICSNETID=CICSNET
HWSC0001I      ISCUSER  STATUS    SENDCLNT RECVCLNT
HWSC0001I      IMSUS01  ACTIVE    ISC11111 ISC33333
HWSC0001I      IMSUS02  ACTIVE    ISC22222 ISC44444
HWSC0001I        TOTAL ISCUSERS=2 ACTIVE=2 OTHER=0
HWSC0001I    PORT=9996     STATUS=ACTIVE     KEEPAV=0 NUMSOC=4 EDIT=         TIMEOUT=0
HWSC0001I      CLIENTID USERID   TRANCODE DATASTORE STATUS  SECOND CLNTPORT IP-ADDRESS            APSB-TOKEN
HWSC0001I      CLIENT01 USRT003  ITOC04   IMS1       RECV        27 3464     0:0:0:0:0:FFFF:C000:204
HWSC0001I      CLIENTID LCLPLKID  STATUS SECOND CLNTPORT IP-ADDRESS
HWSC0001I      MSC33333 MSC12     CONN       14 1739     0:0:0:0:0:FFFF:C000:200
HWSC0001I      MSC44444 MSC12     CONN        9 2684     0:0:0:0:0:FFFF:C000:200
HWSC0001I      TOTAL CLIENTS=3  RECV=1 CONN=2 XMIT=0 OTHER=0 
HWSC0001I    PORT=6666C    STATUS=NOT ACTIVE KEEPAV=0 NUMSOC=1 EDIT=         TIMEOUT=0 
HWSC0001I      NO ACTIVE CLIENTS                              
HWSC0001I    PORT=7777C    STATUS=ACTIVE     KEEPAV=0 NUMSOC=3 EDIT=         TIMEOUT=0 
HWSC0001I      
HWSC0001I      CLIENTID ISCNAME STATUS SECOND CLNTPORT  IP-ADDRESS 
HWSC0001I      ISC33333 LU6TCP2   CONN     14     3579  0:0:0:0:0:FFFF:C000:202 
HWSC0001I      ISC44444 LU6TCP2   CONN      9     2468  0:0:0:0:0:FFFF:C000:202 
HWSC0001I      TOTAL CLIENTS=3  RECV=1 CONN=2 XMIT=0 OTHER=0
HWSC0001I    PORT=LOCAL    STATUS=ACTIVE     KEEPAV=0 NUMSOC=0 EDIT=         TIMEOUT=0
HWSC0001I      NO ACTIVE CLIENTS                              
HWSC0001I    PORT=8899S    STATUS=NOT ACTIVE KEEPAV=0 NUMSOC=1 EDIT=         TIMEOUT=0
HWSC0001I      NO ACTIVE CLIENTS                              
HWSC0001I    PORT=8888D    STATUS=ACTIVE     KEEPAV=0 NUMSOC=1 EDIT=         TIMEOUT=600000
HWSC0001I      NO ACTIVE CLIENTS
HWSC0001I    RMTIMSCON=CONNECT2 STATUS=ACTIVE
HWSC0001I      IP-ADDRESS=192.0.2.0       PORT=5555
HWSC0001I      HOSTNAME=WWW.EXAMPLE.COM
HWSC0001I      AUTOCONN=N PERSISTENT=Y
HWSC0001I      IDLETO=6000
HWSC0001I      RESVSOC=10        NUMSOC=2
HWSC0001I      SENDCLNT LCLPLKID STATUS SECOND SENDPORT
HWSC0001I      MSC11111 MSC12    CONN      100 1234
HWSC0001I      MSC22222 MSC12    CONN       89 5678
HWSC0001I    RMTIMSCON=CONNECT3 STATUS=ACTIVE
HWSC0001I      IP-ADDRESS=192.0.2.4       PORT=9999
HWSC0001I      HOSTNAME=WWW.EXAMPLE.COM
HWSC0001I      AUTOCONN=Y PERSISTENT=Y
HWSC0001I      IDLETO=6000
HWSC0001I      RESVSOC=4         NUMSOC=4
HWSC0001I      SENDCLNT USERID   STATUS SECOND SENDPORT
HWSC0001I      OTM11111 USER01   CONN      100 1111
HWSC0001I      OTM22222 USER01   CONN       89 2222
HWSC0001I      OTM33333 USER02   CONN       81 3333
HWSC0001I      OTM44444 USER03   RECV       23 4444
HWSC0001I      TOTAL SENDCLNTS=4 RECV=1 CONN=3 XMIT=0 OTHER=0
HWSC0001I    RMTCICS=ICONNT1   STATUS=NOT ACTIVE       
HWSC0001I      IP-ADDRESS=192.0.2.1        PORT=9997    
HWSC0001I      HOSTNAME=WWW.EXAMPLE.COM                                        
HWSC0001I      NO ACTIVE CLIENTS
HWSC0001I    RMTCICS=ICONNT2   STATUS=ACTIVE       
HWSC0001I      IP-ADDRESS=192.0.2.2        PORT=9998    
HWSC0001I      HOSTNAME=WWW.EXAMPLE.COM                                        
HWSC0001I      SENDCLNT ISCNAME     STATUS SECOND SENDPORT 
HWSC0001I      ISC11111 LU6TCP2     CONN      100 1111
HWSC0001I      ISC22222 LU6TCP2     CONN       89 2222
HWSC0001I      TOTAL SENDCLNTS=2 RECV=0 CONN=2 XMIT=0 OTHER=0