HP-UX SNAplus2 R7 NOF Programmer's Guide

Introduction to the NOF API
NOF Verbs to Manage Specific SNAplus2 Functions
• DEFINE_DOWNSTREAM_LU, DEFINE_DOWNSTREAM_LU_RANGE
To obtain information about the configuration or current status of downstream LUs or about the downstream PU
that serves them, use the following verbs:
• QUERY_DOWNSTREAM_LU, QUERY_DOWNSTREAM_PU
To delete downstream LUs when they are no longer required, use the following verbs:
• DELETE_DOWNSTREAM_LU, DELETE_DOWNSTREAM_LU_RANGE
1.5.10 Managing DLUR
If the node supports DLUR (the dlur_support parameter on the DEFINE_NODE verb), and LUs on the SNAplus2
node will be using DLUR to communicate with host systems, you need to define the PU on the local SNAplus2
node that owns these LUs. This is not the same as defining a PU for LUs that communicate directly with the host
(which is done using the DEFINE_LS verb).
To define the PU, use the following verb:
• DEFINE_INTERNAL_PU
To obtain information about the PU, use the following verb:
• QUERY_PU
To define and manage the LUs associated with this PU, see Section 1.5.3, 3270 Communications, Section 1.5.5,
RJE Communications, or Section 1.5.6, LUA Communications, earlier in this section.
To start the PU (to request an ACTPU from the host) in order to use the LUs or to stop it when applications are no
longer using the LUs, use the following verbs:
• START_INTERNAL_PU, STOP_INTERNAL_PU
To delete the PU when it is no longer required, use the following verb:
• DELETE_INTERNAL_PU
If the local node is a network node, and LUs on downstream PUs will be using DLUR to communicate with host
systems, you need to define the communications link to the downstream PU, as described in Section 1.5.2, Getting
Started. The LS definition must specify that the local node provides DLUR services to the downstream PU.
You do not need to define the downstream PUs; SNAplus2 will obtain the necessary information dynamically
when communications links are established. To obtain information about downstream PUs and LUs currently using
DLUR, use the following verbs:
• QUERY_DOWNSTREAM_PU, QUERY_DOWNSTREAM_LU
To set up defaults to simplify DLUR configuration and reduce the information required on other DLUR verbs, use
the following verb:
• DEFINE_DLUR_DEFAULTS
To obtain information about PUs and LUs currently using DLUR (either on the local node or on downstream PUs),
or about the DLUS nodes they are using, use the following verbs:
• QUERY_DLUR_PU, QUERY_DLUR_LU, QUERY_DLUS
1.5.11 Managing TN Server
If TN3270 users will be using the TN server feature on a SNAplus2 node to communicate with host systems, you
need to define the communications link to the host. For more information, see Section 1.5.2, Getting Started. The
definition of the LS to the host must include the name of a local PU to own the 3270 LUs and must have the
solicit_sscp_sessions parameter set to AP_YES.
56