HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_DOWNSTREAM_LU
This verb can also be used to activate a downstream LU that is already defined (for example, because the downstream
workstation has just been activated). To do this, reissue the DEFINE_DOWNSTREAM_LU verb for that LU. Note
that all parameters must be the same as in the original definition, because you cannot modify the definition.
DEFINE_DOWNSTREAM_LU can also be used to define the downstream LU used by an application that
communicates with a SNAplus2 Primary RUI application. For more information about Primary RUI, see HP-
UX SNAplus2 LUA Programmer’s Guide.
3.22.1 VCB Structure
typedef struct define_downstream_lu
{
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 dslu_name[8]; /* Downstream LU name */
DOWNSTREAM_LU_DEF_DATA def_data; /* Defined data */
} DEFINE_DOWNSTREAM_LU;
typedef struct downstream_lu_def_data
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char nau_address; /* downstream LU nau address */
unsigned char dspu_name[8]; /* Downstream PU name */
unsigned char host_lu_name[8]; /* Host LU or Pool name */
unsigned char allow_timeout; /* Allow timeout of host LU? */
unsigned char delayed_logon; /* Allow delayed logon to */
/* host LU */
unsigned char reserv2[6]; /* reserved */
} DOWNSTREAM_LU_DEF_DATA;
3.22.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DEFINE_DOWNSTREAM_LU
dslu_name
Name of the downstream LU that is being defined. This is an 8-byte type-A EBCDIC string (starting with a
letter), padded on the right with EBCDIC spaces.
def_data.description
A null-terminated text string (0–31 characters followed by a null character) describing the downstream
LU. This string is for information only; it is stored in the node’s configuration file and returned on the
QUERY_DOWNSTREAM_LU verb, but SNAplus2 does not make any other use of it.
def_data.nau_address
Network accessible unit address of the downstream LU. This must be in the range 1–255.
def_data.dspu_name
Name of the downstream PU associated with this LU (as specified on the DEFINE_LS). This is an 8-byte
type-A EBCDIC string (starting with a letter), padded on the right with EBCDIC spaces.
140