HP-UX SNAplus2 R7 NOF Programmer's Guide

ManualsBrandsHP ManualsSoftwareHP-UX SNAplus2 Software

731

732

733

734

735

736

737

738

739

740

NOF API Verbs

START_INTERNAL_PU

This verb must be issued to a running node.

3.186.1 VCB Structure

typedef struct start_internal_pu

{

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 pu_name[8]; /* internal PU name */

unsigned char dlus_name[17]; /* DLUS name */

unsigned char bkup_dlus_name[17]; /* Backup DLUS name */

} START_INTERNAL_PU;

3.186.2 Supplied Parameters

The application supplies the following parameters:

opcode

AP_START_INTERNAL_PU

pu_name

Name of the internal PU to be started (which must have been previously deﬁned using DE-

FINE_INTERNAL_PU). The name is an 8-byte type-A EBCDIC string (starting with a letter), padded on

the right with EBCDIC spaces.

dlus_name

Name of DLUS node which DLUR will contact to solicit SSCP-PU session activation for the given PU. 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.

To use the DLUS speciﬁed in the DEFINE_INTERNAL_PU verb, or the global default speciﬁed in

DEFINE_DLUR_DEFAULTS if none was speciﬁed in DEFINE_INTERNAL_PU, set this parameter to 17

binary zeros.

bkup_dlus_name

Name of DLUS node which DLUR will store as the backup DLUS for the given PU. 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.

To use the backup DLUS speciﬁed in the DEFINE_INTERNAL_PU verb, or the global backup default

speciﬁed in DEFINE_DLUR_DEFAULTS if none was speciﬁed in DEFINE_INTERNAL_PU, set this

parameter to 17 binary zeros.

3.186.3 Returned Parameters: Successful Execution

If the verb executes successfully, SNAplus2 returns the following parameters:

primary_rc

AP_OK

3.186.4 Returned Parameters: Parameter Check

If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:

735