
>>-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.