HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs

CHANGE_SESSION_LIMIT

AP_CHANGE_SESSION_LIMIT

lu_name

LU name of the local LU, as deﬁned to SNAplus2. This is an 8-byte type-A EBCDIC string, padded on the

right with spaces if the name is shorter than 8 bytes. To indicate that the LU is deﬁned by its LU alias instead

of its LU name, set this parameter to 8 binary zeros.

lu_alias

LU alias of the local LU, as deﬁned to SNAplus2. This is an 8-byte ASCII string, using any locally displayable

characters, padded on the right with spaces if the name is shorter than 8 bytes. It is used only if

lu_name is

set to zeros.

To indicate the LU associated with the CP (the default LU), set both lu_name and lu_alias to 8 binary zeros.

plu_alias

LU alias of the partner LU.

This is an 8-byte ASCII string, using any locally displayable characters, padded on the right with spaces if

the name is shorter than 8 bytes. To indicate that the partner LU is deﬁned by its fully qualiﬁed LU name

instead of its LU alias, set this parameter to 8 binary zeros.

fqplu_name

Fully qualiﬁed LU name for the partner LU, as deﬁned to SNAplus2. This parameter is used only if the

plu_alias ﬁeld is set to zeros; it is ignored if plu_alias is speciﬁed.

The name is a 17-byte EBCDIC string, right-padded with EBCDIC spaces. It consists of a network ID of

up to 8 A-string characters, an EBCDIC dot (period) character, and a network name of up to 8 A-string

characters.

mode_name

Name of the mode to be used by the LUs.

This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded on the right with

EBCDIC spaces if the name is shorter than 8 bytes.

set_negotiable

Speciﬁes whether the maximum negotiable session limit for this mode should be modiﬁed. Possible values

are:

AP_YES

Use the value speciﬁed by plu_mode_session_limit as the maximum negotiable session limit for this

LU-LU-mode combination.

AP_NO

Leave the maximum negotiable session limit as the value speciﬁed for the mode.

plu_mode_session_limit

Requested total session limit for this LU-LU-mode combination: the maximum number of parallel sessions

permitted between these two LUs using this mode. Specify a value in the range 1–32,767 (which must not

exceed the session limit speciﬁed for the local LU on the DEFINE_LOCAL_LU verb). This value may be

negotiated with the partner LU.

min_conwinners_source

Minimum number of sessions using this mode for which the local LU is the contention winner. Specify a value

in the range 0–32,767. The sum of the min_conwinners_source and min_conwinners_target parameters must

not exceed the plu_mode_session_limit parameter.

min_conwinners_target