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

Page 147
Image 147
HP UX Internet and Networking Software manual 43 definepartnerlu, Supplied Parameters