HP-UX SNAplus2 R7 Administration Command Reference

Administration Commands
define_partner_lu
The target node is active, so you cannot use this command to modify its configuration. The
define_node command can be issued only to an inactive node.
Other Conditions
Appendix A, Common Return Codes from snapadmin Commands, lists additional combinations of primary and
secondary return codes that are common to all commands.
2.43 define_partner_lu
The define_partner_lu command defines the parameters of a partner LU for LU-LU sessions between a local
LU and the partner LU, or modifies an existing partner LU. You cannot change the partner LU alias of an existing
partner LU.
There is normally no requirement to define partner LUs because SNAplus2 will set up an implicit definition when
the session to the partner LU is established; you usually only need to define the LU if you need to enforce non-
default values for logical record size, conversation security support, or parallel session support. You may also have
an APPC application that uses a partner LU alias when allocating a session, therefore you need to define a partner
LU in order to map the alias to a fully-qualified partner LU name.
If the local node or the remote node where the partner LU is located is a LEN node, you need to define a directory
entry for the partner LU to allow SNAplus2 to access it. To do this, use define_adjacent_len_node.If
both the local and remote nodes are network nodes, or if one is a network node and the other is an end node, the
directory entry is not required, because SNAplus2 can locate the LU dynamically.
2.43.1 Supplied Parameters
Parameter name Type Length Default
[define_partner_lu]
fqplu_name character 17
plu_alias character 8
description character 31 (null string)
plu_un_name character 8 (take from second part
of fqplu_name)
max_mc_ll_send_size decimal 0
conv_security_ver constant NO
parallel_sess_supp constant YES
Supplied parameters are:
fqplu_name
Fully qualified name of the partner LU. Specify 3–17 type-A characters that consist of a 1–8 character network
name, followed by a period, followed by a 1–8 character partner LU name.
plu_alias
LU alias of the partner LU. This alias is a character string using any locally displayable characters.
If the fqplu_name parameter matches the fully qualified name of an existing partner LU, this parameter must
match the partner LU alias in the existing definition. You cannot change the partner LU alias for an existing
partner LU, or set up more than one LU alias for the same fully qualified name. Also, the partner LU alias
cannot match the alias of other partner LUs or local LUs or an error code is returned.
description
A text string describing the partner LU. SNAplus2 uses this string for information only. It
is stored in the node’s configuration file and returned on the query_partner_lu and
query_partner_lu_definition commands.
147