HP-UX SNAplus2 R7 NOF Programmer's Guide

ManualsBrandsHP ManualsSoftwareHP-UX SNAplus2 Software

191

192

193

194

195

196

197

198

199

200

NOF API Verbs

DEFINE_LS_ROUTING

Note

You cannot use DEFINE_LS_ROUTING with an Enterprise Extender (HPR/IP) link station.

This is because all trafﬁc on this link type must ﬂow over an RTP connection, which is not

ﬁxed to a particular link station and can switch to a different path.

3.30.1 VCB Structure

typedef struct define_ls_routing

{

AP_UINT16 opcode; /* verb operation code */

unsigned char reserv2; /* reserved */

unsigned char format; /* reserved */

AP_UINT16 primary_rc; /* primary return code */

AP_UINT32 secondary_rc; /* secondary return code */

unsigned char lu_name[8]; /* LU Name */

unsigned char lu_alias[8]; /* reserved */

unsigned char fq_partner_lu[17]; /* partner lu name */

unsigned char wildcard_fqplu; /* wildcard partner LU flag */

unsigned char ls_name[8]; /* link to use */

unsigned char reserv3[2]; /* reserved */

} DEFINE_LS_ROUTING;

3.30.2 Supplied Parameters

The application supplies the following parameters:

opcode

AP_DEFINE_LS_ROUTING

lu_name

Name of the local LU that will communicate with the partner LU (speciﬁed by the fq_partner_lu parameter)

over the link speciﬁed by the ls_name parameter. This is an 8–byte type-A character string.

fq_partner_lu

Fully qualiﬁed name of the partner LU with which the local LU (speciﬁed by the lu_name parameter) will

communicate over the link speciﬁed by the ls_name parameter. Specify 3–17 characters that consists of a

1–8 character network name, followed by a period, followed by a 1–8 character partner LU name.

You can specify a partial or full wildcard partner LU name by specifying only part of the name and setting

the wildcard_fqplu parameter to AP_YES. For example:

• APPN.NEW matches APPN.NEW1, APPN.NEWLU, and so on

• APPN. matches any LU with a network name of APPN, regardless of its LU name

• APPN matches any LU with a network name beginning with APPN: APPN.NEW1, APPNNEW.LUTWO,

and so on.

To specify a full wildcard entry, so that all partner LUs will be accessed using the same link, set wildcard_fqplu

to AP_YES and set fq_partner_lu to a null string.

wildcard_fqplu

Wildcard partner LU ﬂag indicating whether the fq_partner_lu parameter contains a full or partial wildcard.

Possible values are:

AP_YES

195