MNAD gate, INQUIRE_ASSOCIATED_DATA function

Inquire on association data for a task.

Input parameters

TRANNUM
The 4-byte number of the task.

Output parameters

All output parameters are optional.

APPLICATION_NAME
The 64-character name of the application.
C_APPLID
An 8-character APPLID of the CICS region in which this task is running.
C_CLIENT_IPADDR
The 39-character IP address of the TCP/IP client that requested this task to start.
C_CLIENT_PORT
A 31-bit binary value that represents the number of the port that the TCP/IP stack used to send the request that resulted in this task being attached.
C_CLNTIPADDR_FAMILY
The client IP address family can have the following values:
  • IPV4
  • IPV6
  • UNKNOWN
C_FACILITY_NAME
The 8-character name of the facility associated with the initiation of this task.
C_FACILITY_TYPE
The type of facility that initiated this task. This parameter can have one of the following values:
  • APPC_SESSION
  • BRIDGE
  • EVENT
  • IIRR
  • IP_ECI
  • IS_SESSION
  • LU61_SESSION
  • MRO_SESSION
  • NONE
  • RRS_UR
  • RZ_INSTORE_TRPORT
  • SCHEDULER
  • SOCKET
  • START
  • START_TERMINAL
  • TERMINAL
  • TRANDATA
  • WEB
  • XM_RUN_TRANSACTION
C_IPADDR_FAMILY
The IP address family can have the following values:
  • IPV4
  • IPV6
  • UNKNOWN
C_IPCONN
An 8-character name of any IPIC connection that was used to receive a request that resulted in this task starting.
C_MVSIMAGE
The 8-character name of the MVS image associated with the TCPIPSERVICE resource used to receive a request that resulted in this task starting.
C_NETID
The 8-character network ID of the terminal from which this task was started.
C_NETNAME
The 8-character name of the terminal from which this task was started.
C_PROGRAM_NAME
The 8-character name of the first program called by a task running this transaction.
C_SERVER_IPADDR
The 39-character area that represents the IP address of the TCP/IP service that scheduled this task.
C_SERVER_PORT
A 31-bit binary value that represents the port number on which the TCPIPSERVICE resource that received the request that resulted in this task being attached is listening.
C_START_TIME
A 21-character representation of the time when this task was started.
C_TCPIP_APPLDATA
The 40-character value of the application data associated by CICS with the socket that received the request that started this task.
C_TCPIP_ZONENAME
The 8-character name of the TCP/IP network security zone associated with the IPIC connection that received the request that resulted in this task starting.
C_TCPIPJOB
The 8-character name of the TCP/IP job associated with the IPIC connection that received the request that resulted in this task starting.
C_TCPIPSERVICE
The 8-character name of the TCPIPSERVICE resource associated with the IPIC connection that received the request that resulted in this task starting.
C_TRANSACTION_GROUP_ID
The 28-character unique identifier that represents the transaction group ID of the originating transaction.
C_USERID1
The 8-character user ID associated with this task.
C_USERID2
The 8-character user ID of the initiating task.
C_SRVRIPADDR_FAMILY
The server IP address family can have the following values:
  • IPV4
  • IPV6
  • UNKNOWN
CLIENT_LOCATION
The 32-character area that represents the SO_CLUSTERCONNTYPE socket option returned by z/OS Communications Server for the facility.
MAJOR_VERSION
The fullword binary value that is the major version of the application.
MICRO_VERSION
The fullword binary value that is the micro version of the application.
MINOR_VERSION
The fullword binary value that is the minor version of the application.
O_APPLID
The 8-character APPLID for the origin descriptor associated with the task.
O_NETWORKID
The 8-character network qualifier for the origin region APPLID on which the task ran.
O_START_TIME
The 21-character representation of the time when the originating task started.
O_TASK_NUMBER
The 4-byte packed decimal identifier of the originating task that is associated with this task.
O_1ST_TRANSID
The 4-character name of the transaction under which the originating task ran.
O_USERID2
The 8-character user ID under which the originating task ran.
O_FACILITY_TYPE
The type of facility that initiated the originating task that is associated with this task. This parameter can have one of the following values:
  • BRIDGE
  • NONE
  • SCHEDULER
  • SOCKET
  • START
  • START_TERMINAL
  • TERMINAL
  • TRANDATA
  • WEB
  • XM_RUN_TRANSACTION
O_FACILITY_NAME
An 8-character name of the facility. This parameter is populated when the facility associated with the initiation of the originating task is a transient data queue, a terminal, or a system.
O_NETID
The 8-character network ID of the terminal from which the originating task was started.
O_NETNAME
The 8-character network qualifier for the origin region APPLID on which the task ran.
O_IPADDR_FAMILY
The form of TCP/IP addressing used by the originating task. This parameter can have the following values:
  • IPV4
  • IPV6
  • UNKNOWN
O_CLIENT_IPADDR
The 39-character IP address of the TCP/IP client that requested the originating task to start.
O_CLIENT_PORT
A 31-bit binary value that represents the port number that the TCP/IP stack used to send the request that resulted in attaching the originating task.
O_USER_CORRELATOR
A 64-character area that contains the user correlator data that was added to the associated data origin descriptor by an XAPADMGR global user exit program.
O_ADAPTER_ID
A 64-character area that contains the data that was added to the origin data by the adapter.
O_ADAPTER_DATA_1
A 64-character area that contains the data that was added to the origin data by the adapter.
O_ADAPTER_DATA_2
A 64-character area that contains the data that was added to the origin data by the adapter.
O_ADAPTER_DATA_3
A 64-character area that contains the data that was added to the origin data by the adapter.
OPERATION_NAME
The 64-character name of the application operation.
PLATFORM_NAME
The 64-character name of the platform.
REASON
The following values are returned when RESPONSE is EXCEPTION:
  • NOT_FOUND
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


dfhs3_MNADinquire_associated_data.html | Timestamp icon Last updated: Monday, 5 June 2017