list-nodes-dcom

DRAFT
Previous Next Contents

list-nodes-dcom

lists all \{product---name} nodes that support communication over DCOM in a domain

Synopsis

asadmin [asadmin-options] list-nodes-dcom [--help]
[--long={false|true}]

Description

The list-nodes-dcom subcommand lists all \{product---name} nodes that support communication over the Distributed Component Object Model (DCOM) remote protocol. The DCOM protocol is available only on Windows systems.

Note

To list all nodes in a domain regardless of the type of the node, run the list-nodes(1) subcommand.

By default, the subcommand displays the following information for each node that is listed:

  • The name of the node

  • The type of the node, which is DCOM

  • The name of the host that the node represents

The --long option of the subcommand specifies whether the nodes are listed in long format. In long format, the following additional information about each node is displayed:

  • The path to the parent of the base installation directory of \{product---name} on the host that the node represents

  • A comma-separated list of the names of the \{product---name} instances that reside on the node

If the --terse option of the asadmin(1M) utility is true and the --long option of the subcommand is false, the subcommand lists only the name of each node.

This subcommand is supported in remote mode only.

Options

asadmin-options

Options for the asadmin utility. For information about these options, see the asadmin(1M) help page.

--help
-?

Displays the help text for the subcommand.

--long
-l

Specifies whether the nodes are listed in long format.
Possible values are as follows:

true

The nodes are listed in long format.

false

The nodes are listed in short format (default).

Examples

Example 1   Listing \{product---name} Nodes

This example displays the name, type, and host for all \{product---name} nodes that support communication over DCOM in a domain.

asadmin> list-nodes-dcom
xkyd  DCOM  xkyd.example.com
wpmdl2  DCOM  wpmdl2.example.com
wpmdl1  DCOM  wpmdl1.example.com
Command list-nodes-dcom executed successfully.

Example 2   Listing Only the Names of \{product---name} Nodes

This example uses the --terse option of the asadmin utility to list only the names of the \{product---name} nodes that support communication over DCOM in a domain.

asadmin> list-nodes-dcom --terse=true
xkyd
wpmdl2
wpmdl1

Example 3   Listing \{product---name} Nodes in Long Format

This example lists the \{product---name} nodes that support communication over DCOM in a domain in long format.

asadmin> list-nodes-dcom --long=true
NODE NAME    TYPE   NODE HOST            INSTALL DIRECTORY   REFERENCED BY
xkyd         DCOM   xkyd.example.com     C:\glassfish3
wpmdl2       DCOM   wpmdl2.example.com   C:\glassfish3       wdi2
wpmdl1       DCOM   wpmdl1.example.com   C:\glassfish3       wdi1
Command list-nodes-dcom executed successfully.

Exit Status

0

command executed successfully

1

error in executing the command

See Also

asadmin(1M)

create-node-config(1), create-node-dcom(1), create-node-ssh(1), delete-node-config(1), delete-node-dcom(1), delete-node-ssh(1), list-nodes(1), list-nodes-config(1), list-nodes-dcom(1)

Previous Next Contents
Eclipse Foundation Logo  Copyright © 2019, Oracle and/or its affiliates. All rights reserved.

DRAFT