HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_FOCAL_POINT
AP_INVALID_SESSION_TYPE
The emulator_type or session_type parameter for one or more sessions was not set to a valid value.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.25.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.25.6 Defining Partner LUs
This verb allows you to specify the partner LU using either its fully qualified LU name or its LU alias. If you
specify the fully qualified name, no additional configuration of the partner LU is required; if you specify the LU
alias, you must also use DEFINE_PARTNER_LU to define the fully qualified name corresponding to this alias, so
that SNAplus2 can locate the LU when it is required by a session.
If the 5250 emulation program requires LUs to be specified by LU alias rather than by fully qualified name (this
applies to many Windows-based 5250 emulation programs that use the WinSNA APIs), you must specify the LU
alias on this command, and use DEFINE_PARTNER_LU as above.
3.26 DEFINE_FOCAL_POINT
The DEFINE_FOCAL_POINT verb specifies the focal point for a particular Management Services category. When
a new focal point is specified, SNAplus2 attempts to establish an implicit primary focal point relationship with the
specified focal point by sending an MS_CAPABILITIES request.
3.26.1 VCB Structure
typedef struct define_focal_point
{
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 reserved; /* reserved */
unsigned char ms_category[8]; /* management services category */
unsigned char fp_fqcp_name[17]; /* Fully qualified focal */
/* point cp name */
unsigned char ms_appl_name[8]; /* Focal point application name */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char backup; /* is focal point a backup */
unsigned char reserv3[16]; /* reserved */
} DEFINE_FOCAL_POINT;
3.26.2 Supplied Parameters
The application supplies the following parameters:
156