INQUIRE PARTNER
Retrieve information about a partner.
Description
The INQUIRE PARTNER command returns information about a partner from the partner resource table.
Browsing
You can also browse through all of the partners defined in your system by using the browse options (START, NEXT, and END) on INQUIRE PARTNER commands. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.
Options
- NETNAME(data-area)
- returns the 8-character name of the z/OS® Communications Server node in which the partner is located.
- NETWORK(data-area)
- returns the 8-character name of the network in which the partner is located. If this value is blank, the partner is in the same network as your CICS® system.
- PARTNER(data-value)
- specifies the 8-character name of the partner about which you are inquiring. This is the name assigned in its PARTNER resource definition.
- PROFILE(data-area)
- returns the 8-character name of the PROFILE definition specified in the PARTNER definition.
- TPNAME(data-area)
- returns the name of the remote transaction program that runs on the partner LU (from the TPNAME or XTPNAME value in the PARTNER resource definition). This name can be up to 64 characters long; you can determine the actual length with the TPNAMELEN option.
- TPNAMELEN(data-area)
- returns a halfword binary field giving the length in bytes of the information returned in TPNAME.
Conditions
- END
- RESP2 values:
- 2
- There are no more resource definitions of this type.
- ILLOGIC
- RESP2 values:
- 1
- You have issued a START command when a browse of this resource type is already in progress, or you have issued a NEXT or an END command when a browse of this resource type is not in progress.
- NOTAUTH
- RESP2 values:
- 100
- The user associated with the issuing task is not authorized to use this command.
- PARTNERIDERR
- RESP2 values:
- 1
- The partner cannot be found.
- 2
- Partner Resource Manager (PRM) is not active, because it failed to initialize during CICS initialization.