Querying the Node

These verbs return node information in named fields:
  • QUERY_DEFAULT_PU
  • QUERY_DLUR_DEFAULTS
  • QUERY_MDS_STATISTICS
  • QUERY_NN_TOPOLOGY_STATS

    The Communications Server icon lets you know that there is a change in the way things operate.
    		 QUERY_NN_TOPOLOGY_STATS is Communications Server only.
  • QUERY_NODE
  • QUERY_STATISTICS
The following verbs can return one or more units of information:
  • QUERY_ADJACENT_NN
  • QUERY_ADJACENT_NODE
  • QUERY_CN
  • QUERY_CN_PORT
  • QUERY_COS
  • QUERY_DEFAULTS
  • QUERY_DLUS
  • QUERY_DOWNSTREAM_PU

    The Communications Server icon lets you know that there is a change in the way things operate.
    		 QUERY_DOWNSTREAM_PU is Communications Server only.
  • QUERY_DSPU_TEMPLATE
  • QUERY_FOCAL_POINT
  • QUERY_LU_POOL
  • QUERY_LU62_TIMEOUT
  • QUERY_MDS_APPLICATION
  • QUERY_MODE_TO_COS_MAPPING
  • QUERY_NMVT_APPLICATION
  • QUERY_PU
  • QUERY_TP
This information can be thought of as being stored in the form of a list. The verb can specify a named entry in the list, which is then considered to be a place marker (or index value) in the list. The list_options field on these verbs specifies from which point in the list information will be returned.
  • If list_options is set to AP_FIRST_IN_LIST, then the fields specifying the index value will be ignored, and the returned list will start at the beginning.
  • If list_options is set to AP_LIST_INCLUSIVE, then the returned list will start from the specified index value.
  • If list_options is set to AP_LIST_FROM_NEXT, then the returned list will start from the entry after the specified index value.

The index value specifies the starting point for returned information. Once this has been determined, some of the query verbs also provide additional filtering options for the returned list. These are specified independently of the index value. Note that unless specified otherwise, the returned list will be ordered according to IBM's 6611 APPN® MIB. (See IBM APPN MIB Tables for information on how verb parameters map to MIB table entries.)

The number of entries to be returned or the buffer size to be filled is set. (If both are set, then the verb is returned with the lower of the two specified quantities of information.) Because the application buffer size typically limits the amount of information that can be returned, the Node Operator Facility returns additional information indicating the total amount of buffer space required to return the requested information, and the total number of entries this represents.

In addition to returning one or more units of information, the following verbs are also able to return different levels of information. The list_options field specifies whether summary or detailed information will be returned by including either AP_DETAIL or AP_SUMMARY in the list_options field. These options are specified by ORing one of the previous list_options, for example: AP_DETAIL | AP_FIRST_IN_LIST.
  • QUERY_DIRECTORY_LU
  • QUERY_DLC
  • QUERY_DLUR_LU
  • QUERY_DLUR_PU
  • QUERY_DOWNSTREAM_LU

    The Communications Server icon lets you know that there is a change in the way things operate.
    		 QUERY_DOWNSTREAM_LU is Communications Server only.
  • QUERY_ISR_SESSION

    The Communications Server icon lets you know that there is a change in the way things operate.
    		 QUERY_ISR_SESSION is Communications Server only.
  • QUERY_LOCAL_LU
  • QUERY_LOCAL_TOPOLOGY
  • QUERY_LS
  • QUERY_LU_0_TO_3
  • QUERY_MODE
  • QUERY_MODE_DEFINITION
  • QUERY_NN_TOPOLOGY_NODE

    The Communications Server icon lets you know that there is a change in the way things operate.
    		 QUERY_NN_TOPOLOGY_NODE is Communications Server only.
  • QUERY_NN_TOPOLOGY_TG

    The Communications Server icon lets you know that there is a change in the way things operate.
    		 QUERY_NN_TOPOLOGY_TG is Communications Server only.
  • QUERY_PARTNER_LU
  • QUERY_PARTNER_LU_DEFINITION
  • QUERY_PORT
  • QUERY_RTP_CONNECTION
  • QUERY_SESSION
  • QUERY_TP_DEFINITION