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.