PARTNER attributes

Describes the syntax and attributes of the PARTNER resource.

DESCRIPTION(text)

You can provide a description of the resource that 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 parenthesis. 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 lowercase characters you enter are converted to uppercase.

The GROUP name can be up to eight characters in length. Lowercase characters are treated as uppercase characters.

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 that 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 that 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 that you enter are converted to uppercase.

It is preferable not to use partner names that start with DFH because these characters are reserved for use by CICS.

CICS can delete or discard them and replace them with CICS resources when you upgrade or provide new function or fixes.

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 (CPI-C) 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 $ @ # . / - _ % & ? ! : \| " = ¬ , ; < >`

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 $ @ # . / - _ % & ? ! : \| " = ¬ , ; < >`

If this range of characters is not sufficient for a name that you want 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.