Distributed Name Service (DNS) Management Programming Manual

LISTOPENS Command
Using DNS in Programs: The DNS Commands
5–198 46958 Tandem Computers Incorporated
ZDNS-LISTO-PROC-BR
is the response buffer that supplies the information about the openers of the
process. It has the token number ZDNS-TNM-LISTO-PROC-BR and the definition
ZDNS-DDL-LISTO-PROC-BR. This token is included in the response for the C-
series systems. It contains the following fields:
ZPRIPROCESSID
contains the ID of the primary opener.
ZBACKUPPROCESSID
contains the ID of the backup opener (if the open is paired).
The contents of the ZPRIPROCESSID and ZBACKUPPROCESSID fields in this
token are determined as follows:
If the process is named, the name is fewer than seven characters long
(including “$”), and the opener is local to the name manager’s node, then
ZPRIPROCESSID contains the process’s name, in local format. If the process
is running at a high PIN, the process-pair form is used (word[3] = “ ”). If the
open is paired, ZBACKUPPROCESSID is similarly constructed.
If the process is named, the name is fewer than six characters long (including
“$”), and the opener is remote to the name manager’s node, then
ZPRIPROCESSID contains the network form of the process’s name. If the
process is running at a high PIN, the process-pair form is used (word[3] = “ ”).
If the open is paired, ZBACKUPPROCESSID is similarly constructed.
If the process is unnamed and PROCESSHANDLE_TO_CRTPID_ is able to
convert the opener’s process handle to a process ID, the returned process ID is
used.
Otherwise, ZMAP-TKN-LISTO-PROC-BR.ZPRIPROCESSID contains a
synthetic process ID as follows:
PROCESSID[0]. 0:7 = %200
PROCESSID[0]. 8:15 = System Number
PROCESSID[1:2] = spaces
PROCESSID[3] = -1
ZSPI-TKN-RETCODE
is the standard SPI return token described in the Distributed Systems Management
(DSM) Programming Manual. This token is present in every response record. If its
value is zero (ZDNS-ERR-NOERR), this token indicates that the information is
successfully retrieved. If ZSPI-TKN-RETCODE is not zero, the information is not
successfully retrieved. Where a non-zero return code is present, the response
buffer may contain one or more error lists. Even if the return code is zero, the
response may still contain error lists that describe warnings.