ftshwi

Note on usage

Function: Display information on instances

User group: FT user

Functional description

The ftshwi command allows you to display information on the openFT instances.

Format

ftshwi -h | [ -l | -d ] [ <instance 1..8> | @a ]

Description

-h

Displays the command syntax on the screen. Entries after the -h are ignored.

-l

(long) Detailed information is output, consisting of the instance name, the host name
and the instance directory. In single-user mode additionally the owner of the instance is
output.

-d

Displays only the instance directory.

If neither -l nor -d are set, only the instance name is displayed.

instance | @a

Name of the instance on which you want information to be displayed.Instance names have a maximum length of 8 characters and must consist of alphanumeric characters. The first character must not be a number.

@a for instance

Information on all instances is output. If neither an instance name nor @a is specified, information is displayed on the instance that is currently set.

Examples

1. You enter ftshwi immediately after installation:

   ftshwi -l @a

   Output on Unix systems:

   Instance Address           Directory 
   -------  -------           -----------
   std      -                 /var/openFT/std
   

   Output on Windows systems:

   Instance Address             Directory
-------    -------             -----------

   std       

   •                   C:\ProgramData\Fujitsu Technology

   Solutions\openFT\var\std

   The output "-" under Address means that the standard instance logs into all addresses of the system and only accepts inbound connections for all the addresses.

2. You enter ftshwi after the FT administrator has assigned the standard instance the address MAPLE using the ftmodi command:

   ftshwi -l @a

   Output on Unix systems:

   Instance Address           Directory 
   -------  -------           -----------
   std      MAPLE             /var/openFT/std
   

   Output on Windows systems:

   Instance Address               Directory

   -------    -------               -----------

   cluster    OPENFT.XYZ.NET        S:\openFT\cluster
std        MAPLE                 C:\Program Files\openFT\var\std

   The standard instance only logs into the address MAPLE and only accepts inbound connections for all the address MAPLE.

3. You enter

   ftshwi in a cluster configuration with several instances:

   ftshwi -l @a

   Output on Unix systems:

   Instance Address             Directory 
   -------  -------             -----------
   maple    CL_MAPLE           /sha_MAPLE/oFT
   beech    CL_BEECH           /sha_BEECH/oFT
   std      MAPLE              /var/openFT/std
   

   Output on Windows systems:

   Instance Address               Directory

   -------    -------               -----------

   cluster    OPENFT.XYZ.NET        S:\openFT\cluster
std     P870_DDM        C:\ProgramData\Fujitsu Technology Solutions

   \openFT\var\std

4. You enter ftshwi in single-user mode on Unix systems.

   ftshwi -l @a
   Instance  Addresse             Owner
                                  Directory
   -------  -------               -----------
   aba      host0                 aba
                                  /var/openFT/aba
   std      MAPLE                 fts
                                  /var/openFT/std
   

Messages of the ftshwi command

If ftshwi could not be executed properly, a self-explaining message is output. The exit code is not equal zero in this case.