PARTNER definition attributes

Read syntax diagramSkip visual syntax diagram
>>-PARTNER(name)--GROUP(groupname)--+-------------------+------->
                                    '-DESCRIPTION(text)-'   

>--NETNAME(netname)--+------------------+----------------------->
                     '-NETWORK(network)-'   

   .-PROFILE(DFHCICSA)-.                         
>--+-------------------+--+-TPNAME(tpname)---+-----------------><
   '-PROFILE(profile)--'  '-XTPNAME(xtpname)-'   

DESCRIPTION(text)
You can provide a description of the resource you are defining in this field. The description text can be up to 58 characters in length. There are no restrictions on the characters that you can use. However, if you use parentheses, ensure that for each left parenthesis there is a matching right one. If you use the CREATE command, for each single apostrophe in the text, code two apostrophes.
GROUP(groupname)
Every resource definition must have a GROUP name. The resource definition becomes a member of the group and is installed in the CICS system when the group is installed.
Acceptable characters:
A-Z 0-9 $ @ #
Any lower case characters you enter are converted to upper case.

The GROUP name can be up to eight characters in length. Lowercase characters are treated as uppercase characters. Do not use group names beginning with DFH, because these characters are reserved for use by CICS.

NETNAME(netname)
is the netname of the logical unit on which the partner application program is running. It matches the NETNAME attribute specified in the CONNECTION definition. The name can be up to eight characters in length.
Acceptable characters:
A-Z 0-9 $ @ #
Unless you are using the CREATE command, any lowercase characters you enter are converted to uppercase.
NETWORK(network)
You can use this optional attribute to specify the name of the network on which the partner LU is located. The name can be up to eight characters in length.
Acceptable characters:
A-Z 0-9 $ @ #
Unless you are using the CREATE command, any lowercase characters you enter are converted to uppercase.
PARTNER(name)
specifies the name of this PARTNER definition. The name can be up to eight characters in length.
Acceptable characters:
A-Z 0-9 
Unless you are using the CREATE command, any lowercase characters you enter are converted to uppercase.
Do not use partner names beginning with DFH, because these characters are reserved for use by CICS.

A partner definition specifies the SAA communications interface information required to establish a conversation with a partner program. For further guidance on this, see Common Programming Interface Communications Reference.

PROFILE(profile)
specifies the name of the PROFILE definition which is to be used for the session and conversation. The default PROFILE is DFHCICSA. The name can be up to 8 characters in length.
Acceptable characters:
A-Z a-z 0-9 $ @ # . / - _ % & ¢ ? ! : | " = ¬ , ; < >
For information about entering mixed case information, see Entering mixed case attributes.
TPNAME(tpname)
specifies the name of the remote transaction program that will be running on the partner LU. The definition of a remote TP name is mandatory; you must specify either TPNAME or its alternative, XTPNAME. This name can be up to 64 characters in length.
Acceptable characters:
A-Z a-z 0-9 $ @ # . / - _ % & ¢ ? ! : | " = ¬ , ; < >
For information about entering mixed case information, see Entering mixed case attributes.
If this range of characters is not sufficient for a name that you wish to specify, you may use the XTPNAME attribute instead of TPNAME.
XTPNAME(xtpname)
This attribute may be used as an alternative to TPNAME; you must specify one of the two, because the definition of a remote TP name is mandatory.

Enter a hexadecimal string up to 128 characters in length, representing the name of the remote transaction program that runs on the partner LU. All hexadecimal combinations are acceptable except X'40'.

To specify an XTPNAME more than 72 characters long to DFHCSDUP, put an asterisk in column 72. This causes the following line to be concatenated.