12.3.11 stgenvdisp (Environment information display command)

NAME

stgenvdisp - displays the values of the environment settings

SYNOPSIS

<program-directory>\bin\stgenvdisp [-n Server-Name]

DESCRIPTION

This command displays the values of the environment settings in AdvancedCopy Manager.
The contents of the displayed information are described below.

Title	Description
Server type	The server type is displayed as follows: Management server : Management Server or Management Server transaction Server : Managed Server or Managed Server transaction
Cluster system	The type of clustered system is displayed as follows: VERITAS Cluster Server : VERITAS Cluster Server MSCS : MSCS or WSFC HACMP : High Availability Cluster Multi-Processing GENERAL : Clustered system on Solaris, Linux, or HP-UX environment
Node type	The node type is displayed as follows: Primary : Primary node Secondary : Secondary node
Node name	The logical node name is displayed. Local-Service indicates a local transaction.
Service name	The transaction name is displayed.
Cluster name	The cluster name is displayed.
Mount point	The mount point for AdvancedCopy Manager shared data is displayed.
Disk resource	The name of the shared disk resource used for AdvancedCopy Manager shared data is displayed.
Drive	The drive letter used for AdvancedCopy Manager shared data is displayed.
Network name	The network name used for AdvancedCopy Manager is displayed.
External connection	The external connection network name is displayed.
Subnet mask	The subnet mask is displayed.
IP address resource	IP address resource information is displayed.
IP by cluster setup	The IPv4 format logical IP address specified in the cluster setting command is displayed. However, note that the displayed IP address is not the active logical IP address if the IP address in either "11.5.7.1 Changing the IP address of Management Server transaction" or "11.5.7.2 Changing the IP address of Managed Server transaction" is changed during operation.
IPv6 by cluster setup	The IPv6 format logical IP address specified in the cluster setting command is displayed. However, note that the displayed IP address is not the active logical IP address if the IP address in either "11.5.7.1 Changing the IP address of Management Server transaction" or "11.5.7.2 Changing the IP address of Managed Server transaction" is changed during operation.
Manager IP address	The IP address of the Management Server is displayed. Displayed information varies with the Server type. For "Management server" The IP address of the Management Server is displayed. If both IPv4 address and IPv6 address are set, they are displayed in two lines. For "Managed server" The IP address of the Management Server to which this Managed Server is registered is displayed. IPv4 address or IPv6 address is displayed. However, if the Managed Server is not registered on the Management Server (operation of adding servers is not done), "????" is displayed in the value field. IPv6 address is expressed in abbreviated notation.
Repository user	The name of the user accessing the repository is displayed.
DB log file	Windows Version only: The name of the DB log file storage destination folder is displayed.
DB dictionary file	Windows Version only: The name of the DB dictionary file storage destination folder is displayed.
Repository database	Windows Version only: The name of the repository DB storage destination folder is displayed.
DB file	Solaris Version: The name of the DB file system device or directory is displayed. Linux Version: The DB file directory name is displayed.
RDB dictionary	Solaris Version: The RDB dictionary raw device name is displayed. Linux Version: The RDB dictionary directory name is displayed.
RDB log file	Solaris Version: The name of the RDB log file raw device or directory is displayed. Linux Version: The RDB log file directory name is displayed.
Database space	Solaris Version: The name of the raw device containing the repository data storage DB is displayed. Linux Version: The name of the directory containing the repository data storage DB is displayed.
Database size	Windows and Linux Version only: The database size is displayed.
Communication	The communication service port number (the service name in the services file: stgxfws) is displayed. In a cluster environment, the transaction communication service port number (the service name in the services file: stgxfws_logical-node-name) is displayed.
Remote access	The remote access service port number (the service name in the services file: rmiswstf) is displayed.
Exclusive control	The exclusive control service port number (the service name in the services file: semswstf) is displayed.
Repository	Windows and Solaris Version only: The repository service port number (the service name in the services file: rdaswstf) is displayed.
Program install directory	Displays the "Program directory" specified during installation.
Fixed configuration directory	Displays the "Environment directory" specified during installation.
Modifying configuration directory	Displays the "Work directory" specified during installation.
Version	Displays the version and level of AdvancedCopy Manager.
Language	Displays the AdvancedCopy Manager language type. JAPANESE : Japanese version ENGLISH : English version
Code	Solaris and Linux Version only: Displays the encoding specified during installation.

OPTIONS

-n Server-Name

Specifies the logical node name (logical node name specified in the cluster setup command) of the transaction.

In a cluster environment: If this option is specified, information on only the specified transactions is output. Otherwise, information on all transactions is output.

In a non-cluster environment: This option cannot be specified. If the option is specified, then message swstf6002 is output and processing ends.
Otherwise, information is output.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

Information in a non-clustered system is displayed:

[For Management Server using IPv4 address]

C:\>C:\ETERNUS_SF\ACM\bin\stgenvdisp
  Server type            : Management server
  Manager IP address     : 10.10.10.10
  Repository user        : acm
  DB log file            : D:\acmdb\log
  DB dictionary file     : D:\acmdb\dic
  Repository database    : D:\acmdb\spa
  Database size          : 65MB
  Communication          : 1226
  Remote access          : 9851
  Exclusive control      : 9852
  Repository             : 2004
-------------------------------------------------------------------------
  Version                : V15.3
  Language               : ENGLISH
  Program install directory          : C:\ETERNUS_SF\ACM
  Fixed configuration directory      : C:\ETERNUS_SF\ACM
  Modifying configuration directory  : C:\ETERNUS_SF\ACM
C:\>

[For Management Server using IPv4 address and IPv6 address]

C:\>C:\ETERNUS_SF\ACM\bin\stgenvdisp
  Server type            : Management server
  Manager IP address     : 10.10.10.10
  Manager IP address     : 2001:db8::1234:0:0:1
  Repository user        : acm
  DB log file            : R:\acmdb\log
  DB dictionary file     : R:\acmdb\dic
  Repository database    : R:\acmdb\spa
  Database size          : 65MB
  Communication          : 1226
  Remote access          : 9851
  Exclusive control      : 9852
  Repository             : 2004
-------------------------------------------------------------------------
  Version                : V15.3
  Language               : ENGLISH
  Program install directory          : C:\ETERNUS_SF\ACM
  Fixed configuration directory      : C:\ETERNUS_SF\ACM
  Modifying configuration directory  : C:\ETERNUS_SF\ACM
C:\>

[For Managed Server using IPv4 address]

C:\>C:\Win32app\AdvancedCopyManager\bin\stgenvdisp
  Server type            : Server
  Manager IP address     : 10.10.10.10
  Communication          : 1226
-------------------------------------------------------------------------
  Version                : V15.3
  Language               : ENGLISH
  Program install directory          : C:\Win32app\AdvancedCopyManager
  Fixed configuration directory      : C:\Win32app\AdvancedCopyManager
  Modifying configuration directory  : C:\Win32app\AdvancedCopyManager
C:\>

[For Managed Server using IPv6 address]

C:\>C:\Win32app\AdvancedCopyManager\bin\stgenvdisp
  Server type            : Server
  Manager IP address     : 2001:db8::1234:0:0:1
  Communication          : 1226
-------------------------------------------------------------------------
  Version                : V15.3
  Language               : ENGLISH
  Program install directory          : C:\Win32app\AdvancedCopyManager
  Fixed configuration directory      : C:\Win32app\AdvancedCopyManager
  Modifying configuration directory  : C:\Win32app\AdvancedCopyManager
C:\>

Information on all transactions in a clustered system (WSFC) is displayed.
The information input by the cluster setup command is output.

[For Managed Server using IPv4 address]

C:\>C:\ETERNUS_SF\ACM\bin\stgenvdisp
  Server type            : Management server
  Cluster system         : MSCS
  Node type              : Primary
  Node name              : nodemgr
  Service name           : manager_service
  Cluster name           : ACMCluster
  Disk resource          : Disk R
  Drive                  : R
  Network name           : ACMNet
  External connection    : local
  Subnet mask            : 255.255.255.0
  IP by cluster setup    : 10.10.10.10
  Manager IP address     : 10.10.10.10
  Repository user        : acm
  DB log file            : R:\acmdb\log
  DB dictionary file     : R:\acmdb\dic
  Repository database    : R:\acmdb\spa
  Database size          : 65MB
  Communication          : 11000
  Remote access          : 9851
  Exclusive control      : 9852
  Repository             : 2004
-------------------------------------------------------------------------
  Server type            : Server
  Node name              : Local-Service
  Manager IP address     : 10.10.10.10
  Communication          : 1226
-------------------------------------------------------------------------
  Version                : V15.3
  Language               : ENGLISH
  Program install directory          : C:\ETERNUS_SF\ACM
  Fixed configuration directory      : C:\ETERNUS_SF\ACM
  Modifying configuration directory  : C:\ETERNUS_SF\ACM
C:\>

[For Management Server using IPv4 address and IPv6 address]

C:\>C:\ETERNUS_SF\ACM\bin\stgenvdisp
  Server type            : Management server
  Cluster system         : MSCS
  Node type              : Primary
  Node name              : nodemgr
  Service name           : manager_service
  Cluster name           : ACMCluster
  Disk resource          : Disk R
  Drive                  : R
  IP by cluster setup    : 10.10.10.10
  IPv6 by cluster setup  : 2001:db8::1234:0:0:1
  Manager IP address     : 10.10.10.10
  Manager IP address     : 2001:db8::1234:0:0:1
  Repository user        : acm
  DB log file            : R:\acmdb\log
  DB dictionary file     : R:\acmdb\dic
  Repository database    : R:\acmdb\spa
  Database size          : 65MB
  Communication          : 11000
  Remote access          : 9851
  Exclusive control      : 9852
  Repository             : 2004
-------------------------------------------------------------------------
  Server type            : Server
  Node name              : Local-Service
  Manager IP address     : 10.10.10.10
  Communication          : 1226
-------------------------------------------------------------------------
  Version                : V15.3
  Language               : ENGLISH
  Program install directory          : C:\ETERNUS_SF\ACM
  Fixed configuration directory      : C:\ETERNUS_SF\ACM
  Modifying configuration directory  : C:\ETERNUS_SF\ACM
C:\>

[For Managed Server and Windows Server 2003]

C:\>C:\Win32app\AdvancedCopyManager\bin\stgenvdisp
  Server type            : Server
  Cluster system         : MSCS
  Node type              : Primary
  Node name              : nodeagt1
  Service name           : agent_service1
  Cluster name           : ACMCluster
  Disk resource          : Disk R
  Drive                  : R
  Network name           : ACMNet1
  External connection    : local
  Subnet mask            : 255.255.255.0
  IP by cluster setup    : 10.10.10.11
  Manager IP address     : 10.10.10.10
  Communication          : 11000
-------------------------------------------------------------------------
  Server type            : Server
  Cluster system         : MSCS
  Node type              : Secondary
  Node name              : nodeagt2
  Service name           : agent_service2
  Cluster name           : ACMCluster
  Disk resource          : Disk P
  Drive                  : P
  IP address resource    : ACM Net Resource
  IP by cluster setup    : 10.10.10.12
  Manager IP address     : 10.10.10.10
  Communication          : 12000
-------------------------------------------------------------------------
  Server type            : Server
  Node name              : Local-Service
  Manager IP address     : 10.10.10.10
  Communication          : 1226
-------------------------------------------------------------------------
  Version                : V15.3
  Language               : ENGLISH
  Program install directory          : C:\Win32app\AdvancedCopyManager
  Fixed configuration directory      : C:\Win32app\AdvancedCopyManager
  Modifying configuration directory  : C:\Win32app\AdvancedCopyManager
C:\>

[For Managed Server using IPv4 address and Windows Server 2008 or later]

C:\>C:\Win32app\AdvancedCopyManager\bin\stgenvdisp
  Server type            : Server
  Cluster system         : MSCS
  Node type              : Primary
  Node name              : nodeagt1
  Service name           : agent_service1
  Cluster name           : ACMCluster
  Disk resource          : Disk R
  Drive                  : R
  Network name           : ACMNet1
  External connection    : local
  Subnet mask            : 255.255.255.0
  IP by cluster setup    : 10.10.10.11
  Manager IP address     : 10.10.10.10
  Communication          : 11000
-------------------------------------------------------------------------
  Server type            : Server
  Cluster system         : MSCS
  Node type              : Secondary
  Node name              : nodeagt2
  Service name           : agent_service2
  Cluster name           : ACMCluster
  Disk resource          : Disk P
  Drive                  : P
  IP by cluster setup    : 10.10.10.12
  Manager IP address     : 10.10.10.10
  Communication          : 12000
-------------------------------------------------------------------------
  Server type            : Server
  Node name              : Local-Service
  Manager IP address     : 10.10.10.10
  Communication          : 1226
-------------------------------------------------------------------------
  Version                : V15.3
  Language               : ENGLISH
  Program install directory          : C:\Win32app\AdvancedCopyManager
  Fixed configuration directory      : C:\Win32app\AdvancedCopyManager
  Modifying configuration directory  : C:\Win32app\AdvancedCopyManager
C:\>

[For Managed Server using IPv6 address]

C:\>C:\Win32app\AdvancedCopyManager\bin\stgenvdisp
  Server type            : Server
  Cluster system         : MSCS
  Node type              : Primary
  Node name              : nodeagt1
  Service name           : agent_service1
  Cluster name           : ACMCluster
  Disk resource          : Disk R
  Drive                  : R
  Network name           : ACMNet1
  IPv6 by cluster setup  : 2001:db8::1234:0:0:2
  Manager IP address     : 2001:db8::1234:0:0:1
  Communication          : 11000
-------------------------------------------------------------------------
  Server type            : Server
  Cluster system         : MSCS
  Node type              : Secondary
  Node name              : nodeagt2
  Service name           : agent_service2
  Cluster name           : ACMCluster
  Disk resource          : Disk P
  Drive                  : P
  IPv6 by cluster setup  : 2001:db8::1234:0:0:3
  Manager IP address     : 2001:db8::1234:0:0:1
  Communication          : 12000
-------------------------------------------------------------------------
  Server type            : Server
  Node name              : Local-Service
  Manager IP address     : 2001:db8::1234:0:0:1
  Communication          : 1226
-------------------------------------------------------------------------
  Version                : V15.3
  Language               : ENGLISH
  Program install directory          : C:\Win32app\AdvancedCopyManager
  Fixed configuration directory      : C:\Win32app\AdvancedCopyManager
  Modifying configuration directory  : C:\Win32app\AdvancedCopyManager
C:\>

NOTES

To output cluster operation information, execute the command from an active node. Executing the command from a standby node displays only partial information. To output cluster operation information while a transaction is stopped, either set the shared disk containing the AdvancedCopy Manager shared data of the transaction to the online state, or mount the shared disk and then execute the command.
When this command is executed in a clustered system, the environment variable SWSTGNODE need not be set.
This command can be executed by an account belonging to the Administrator's group.
"????" is displayed for any information that cannot be displayed because of an error.
Some items may not be output, depending on the server type (whether Management Server or Managed Server) or cluster type.