[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here HP OpenVMS DCL Dictionary

HP OpenVMS DCL Dictionary


Previous Contents Index


SHOW TERMINAL

Displays the current characteristics of a specific terminal. Each characteristic corresponds to an option of the SET TERMINAL command.

Format

SHOW TERMINAL [device-name[:]]


Parameter

device-name[:]

Specifies the name of the terminal for which you want the characteristics displayed. The default is your terminal (SYS$COMMAND).

Description

The SHOW TERMINAL command displays the information about terminal settings for such things as terminal speed, width, number of lines, graphics, and device type.

Note that the SHOW TERMINAL command does not describe terminal fallback characteristics if any are activated. If the Terminal Fallback Facility (TFF) is enabled, you can invoke the Terminal Fallback Utility (TFU) and issue the subcommand SHOW TERMINAL/FALLBACK. For more information, see the OpenVMS Terminal Fallback Utility Manual (available on the Documentation CD-ROM).


Qualifiers

/BRIEF

Displays a subset of more commonly used terminal characteristics.

/FULL (default)

Displays all terminal characteristics.

/OUTPUT[=filespec]

/NOOUTPUT

Controls where the output of the command is sent. If you do not enter the qualifier, or if you enter the /OUTPUT qualifier without a file specification, the output is sent to the current process default output stream or device, identified by the logical name SYS$OUTPUT.

If you enter the /OUTPUT qualifier with a partial file specification (for example, specifying only a directory), SHOW is the default file name and .LIS the default file type. If you enter a file specification, it cannot include the asterisk (*) and the percent sign (%) wildcard characters.

If you enter the /NOOUTPUT qualifier, output is suppressed.

/PERMANENT

Requires LOG_IO (logical I/O) or PHY_IO (physical I/O) privilege.

Displays the permanent characteristics of the terminal.


Examples

#1

$ SHOW TERMINAL/BRIEF
Terminal: _RTA1:      Device_Type: VT300_Series  Owner: _RTA1:
                                              Username: REHOR
Terminal Characteristics:
   Speed:   9600      Page:  62          Width: 80
   No Remote          Hostsync           TTsync
   No Modem           Broadcast          Wrap
   No Hangup          No Disconnect      Overstrike editing
   No Dialup          Application keypad Line Editing
      

In this example, the SHOW TERMINAL command displays a subset of the more commonly used terminal characteristics.

#2

$ SHOW TERMINAL/FULL
Terminal: _TTE4:       Device_Type: VT102         Owner: FRANKLIN
Physical Terminal: _LTA49
   Input:   9600      LFfill:  0      Width:  80      Parity: None
   Output:  9600      CRfill:  0      Page:   24
Terminal Characteristics:
 Interactive        Echo               Type_ahead    No Escape
 No Hostsync        TTsync             Lowercase     Tab
 Wrap               Scope              No Remote     Eightbit
 Broadcast          No Readsync        No Form       Fulldup
 No Modem           No Local_echo      No Autobaud   Hangup
 No Brdcstmbx       No DMA             No Altypeahd  Set_speed
 Line Editing       Overstrike editing No Fallback   No Dialup
 No Secure server   No Disconnect      No Pasthru    No Syspassword
 No SIXEL Graphics  Soft Characters    Printer port  Numeric Keypad
 ANSI_CRT           No Regis           No Block_mode Advanced_video
 Edit_mode          DEC_CRT            DEC_CRT2      No DEC_CRT3
      

In this example, the SHOW TERMINAL command displays the characteristics of this specific terminal. If you are displaying statistics about a terminal allocated to another user, the input, output, LFfill, CRfill, width, page, and parity statistics are not shown (see the next example).

#3

$ SHOW TERMINAL/FULL
Terminal: _RTA1:      Device_Type: VT300_Series  Owner: _RTA1:
                                              Username: VILLA
Remote Port Info: NODE12::VILLA
   Input:    9600     LFfill:  0      Width:  80      Parity: None
   Output:   9600     CRfill:  0      Page:   62
Terminal Characteristics:
 Interactive        Echo             Type_ahead         No Escape
 Hostsync           TTsync           Lowercase          Tab
 Wrap               Scope            No Remote          Eightbit
 Broadcast          No Readsync      No Form            Fulldup
 No Modem           No Local_echo    No Autobaud        No Hangup
 No Brdcstmbx       No DMA           No Altypeahd       Set_speed
 No Commsync        Line Editing     Overstrike editing No Fallback
 No Dialup          No Secure server No Disconnect      No Pasthru
 No Syspassword     SIXEL Graphics   No Soft Characters Printer port
 Application keypad ANSI_CRT         Regis              No Block_mode
 Advanced_video     Edit_mode        DEC_CRT            DEC_CRT2
 DEC_CRT3           No DEC_CRT4      No DEC_CRT5        Ansi_Color
 VMS Style Input
      

In this example, the SHOW TERMINAL command displays the full terminal characteristics.


SHOW TIME

Displays the current date and time.

Format

SHOW [DAY]TIME


Parameters

None.

Example


$ SHOW TIME
   3-NOV-2001 00:02:00

      

The SHOW TIME command in this example displays the current date and time.


SHOW TRANSLATION

Displays the first translation found for the specified logical name. You can specify the tables that are searched.

Requires read (R) access to a logical name table to display information about any logical name cataloged in that table.


Format

SHOW TRANSLATION logical-name


Parameter

logical-name

Specifies the logical name whose translation you want to display.

Description

The SHOW TRANSLATION command searches one or more logical name tables for a specified logical name and returns the equivalence name of the first match found. You can specify the tables you want to search. If you do not specify a table, SHOW TRANSLATION searches the tables defined by the logical name LNM$DCL_LOGICAL.

The logical name LNM$DCL_LOGICAL contains the list of logical name tables and the order in which they are searched. Unless LNM$DCL_LOGICAL has been redefined for your process, the process, job, group, and system logical name tables are searched, in that order. The first match found is displayed. (To see how LNM$DCL_LOGICAL is defined for your process, enter the command SHOW LOGICAL /TABLE=LNM$DIRECTORIES LNM$DCL_LOGICAL.)

If a table contains more than one entry with the same name, but each name has a different mode, then the translation for the name with the outermost (least privileged) mode is returned.

The SHOW TRANSLATION command is similar to the SHOW LOGICAL command; however, the SHOW TRANSLATION command is executed within the DCL command interpreter (the SHOW LOGICAL command calls an image). Therefore, the SHOW TRANSLATION command does not cause the current image to exit and does not deassign user mode logical names. Also, the SHOW TRANSLATION command does not display iterative translations of a name.


Qualifier

/TABLE=name

Searches the specified table. The default value for the name parameter is LNM$DCL_LOGICAL.

If you specify the table name by using a logical name that translates to more than one table, then each table is searched in the order specified until a match is found.


Examples

#1

$ SHOW TRANSLATION PAYROLL
PAYROLL = DISK1:[ACCOUNTS.WORKING]FACTOR1.DAT;37 (LNM$PROCESS_TABLE)
      

The SHOW TRANSLATION command in this example displays the translation for the logical name PAYROLL and also displays the name of the table where the logical name was found. In this example, PAYROLL was found in LNM$PROCESS_TABLE, the process logical name table.

#2

$ DEFINE DISK  DKA1:
$ DEFINE/GROUP DISK  DKA2:
$ SHOW TRANSLATION DISK
  DISK = DKA1:(LNM$PROCESS_TABLE)
      

The DEFINE commands in this example place entries for the logical name DISK in both the process and group logical name tables. Then, the SHOW TRANSLATION command shows the translation associated with the logical name DISK. By default, the process, job, group, and system tables are searched (in that order). The first match found is displayed. The logical name DISK from the process table (LNM$PROCESS_TABLE) is displayed because it is found before the name DISK in the group table.

#3

$ RUN ORION
[Ctrl/Y]
$ SHOW TRANSLATION TERMINAL
  TERMINAL = _TTT3: (LNM$PROCESS_TABLE)
$ CONTINUE
      

The RUN command in this example executes the image ORION.EXE. After the Ctrl/Y function interrupts the image, the SHOW TRANSLATION command displays a logical name assignment. The CONTINUE command resumes the execution of the image.

#4

$ SHOW TRANSLATION/TABLE=LNM$SYSTEM USER
  USER = "DKA2:"  (LNM$SYSTEM_TABLE)
      

The SHOW TRANSLATION command in this example displays the translation for the logical name USER. Because a table name is specified, the SHOW TRANSLATION command does not use the default search order. Only the specified table, LNM$SYSTEM, is searched. LNM$SYSTEM is the system logical name table.

#5

$ DEFINE/TABLE=LNM$PROCESS_DIRECTORY MYPROC -
_$ TEST_TABLE, LNM$PROCESS
$ SHOW TRANSLATION/TABLE=MYPROC FILER
  FILER = "[SMITH.FILER]"   (TEST_TABLE)
      

In this example, MYPROC defines a list of logical name tables that you want searched. It asks the system to first search TEST_TABLE (a user-defined table) and then to search LNM$PROCESS (the process logical name table). MYPROC is stored in LNM$PROCESS_DIRECTORY, the process directory table. When you enter the SHOW TRANSLATION command to find FILER in the MYPROC table, the tables TEST_TABLE and LNM$PROCESS are searched, in that order. The first match found is displayed.


SHOW USERS

Displays the user name and node name (in an OpenVMS Cluster environment) of interactive, subprocess, and batch users on the system.

Format

SHOW USERS [username]


Parameter

username

Specifies the user about whom you want information. The asterisk (*) and the percent sign (%) wildcard characters are allowed. If you specify a string, all users whose user names begin with the string are displayed. For example, if you specify the string MAR, all user names that begin with MAR are displayed. If no user exists whose name matches the specified string, an informational message tells you that no processes were found.

If you omit the username parameter, a list of all interactive, subprocess, and batch users is displayed.


Qualifiers

/BATCH

/NOBATCH

Displays all batch users in the OpenVMS Cluster environment. To restrict the display to users on specific nodes, use the /BATCH qualifier with the /NODE qualifier. When you use the /NOBATCH qualifier, all batch users are excluded from the display.

/CLUSTER

Displays the specified user names on all nodes in an OpenVMS Cluster environment.

/EXACT

Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" ").

If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key.

/FULL

Displays the user name, the node name, the process name, the process identification (PID) code, terminal names (both virtual and physical), and port information of all interactive, subprocess, and batch users on the system.

/HEADING (default)

/NOHEADING

Displays a heading line above the system output. When you use the /NOHEADING qualifier, the heading line is excluded from the display.

/HIGHLIGHT[=keyword]

Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting.

/INTERACTIVE

/NOINTERACTIVE

Displays all interactive processes held by users in the OpenVMS Cluster environment. To restrict the display to users on specific nodes, use the /INTERACTIVE qualifier with the /NODE qualifier. When you use the /NOINTERACTIVE qualifier, all interactive processes held by users in the OpenVMS Cluster environment are excluded from the display.

/NETWORK

/NONETWORK

Displays all network users in the OpenVMS Cluster environment. To restrict the display to users on specific nodes, use the /NETWORK qualifier with the /NODE qualifier. When you use the /NONETWORK qualifier, all network users in the OpenVMS Cluster environment are excluded from the display.

/NODE[=(name,...)]

Displays all interactive, subprocess, and batch users on the specified node or nodes. If you enter the /NODE qualifier without a value, the qualifier displays all the interactive, subprocess, and batch users on the local node.

/OUTPUT[=filespec]

/NOOUTPUT

Controls where the output of the command is sent. By default, the output of the SHOW USERS command is sent to the current SYS$OUTPUT device (usually your terminal). To send the output to a file, use the /OUTPUT qualifier followed by a file specification.

The asterisk (*) and the percent sign (%) wildcard characters are not allowed in the file specification. If you enter a partial file specification (for example, specifying only a directory), SHOW is the default file name and .LIS is the default file type.

If you enter the /NOOUTPUT qualifier, output is suppressed.

/PAGE[=keyword]

/NOPAGE (default)

Controls the display of user information on the screen.

You can use the following keywords with the /PAGE qualifier:

CLEAR_SCREEN Clears the screen before each page is displayed.
SCROLL Displays information one line at a time.
SAVE[= n] Enables screen navigation of information, where n is the number of pages to store.

The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information:

Key Sequence Description
Up arrow key, Ctrl/B Scroll up one line.
Down arrow key Scroll down one line.
Left arrow key Scroll left one column.
Right arrow key Scroll right one column.
Find (E1) Specify a string to find when the information is displayed.
Insert Here (E2) Scroll right one half screen.
Remove (E3) Scroll left one half screen.
Select (E4) Toggle 80/132 column mode.
Prev Screen (E5) Get the previous page of information.
Next Screen (E6), Return, Enter, Space Get the next page of information.
F10, Ctrl/Z Exit. (Some utilities define these differently.)
Help (F15) Display utility help text.
Do (F16) Toggle the display to oldest/newest page.
Ctrl/W Refresh the display.

The /PAGE qualifier is not compatible with the /OUTPUT qualifier.

/SEARCH="string"

Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string.

You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search.

/SUBPROCESS

/NOSUBPROCESS

Displays all subprocess users in the OpenVMS Cluster environment. To restrict the display to users on specific nodes, use the /SUBPROCESS qualifier with the /NODE qualifier. When you use the /NOSUBPROCESS qualifier, all subprocess users in the OpenVMS Cluster environment are excluded from the output.

/WRAP

/NOWRAP (default)

Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line.

The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier.


Examples

#1

$ SHOW USERS
      OpenVMS User Processes at 12-MAY-2001 10:37 AM
    Total number of users = 4,  number of processes = 14
 Username     Node     Interactive  Subprocess   Batch
 S_SKONETSKI BBBBBB            1
 WISNIEWSKI  XXXXXX            4         2
 HIBBITS     AAAAAA            1         4
 VAXMAN      AAAAAA            2
      

The SHOW USERS command in this example displays the user names and node names of all current interactive, subprocess, and batch users on the system.

#2

$ SHOW USERS/NOHEADING/OUTPUT=SYSUSERS.DAT
$ TYPE SYSUSERS.DAT
 S_SKONETSKI BBBBBB            1
 WISNIEWSKI  XXXXXX            4         2
 HIBBITS     AAAAAA            1         4
 VAXMAN      AAAAAA            2
      

The SHOW USERS command in this example displays the user names and node names of all current interactive, subprocess, and batch users on the system without the heading text using the /NOHEADING qualifier. Using the /OUTPUT qualifier, you can write the output to a file for processing or later review.

#3

$ SHOW USERS *LES*
      OpenVMS User Processes at 12-MAY-2001 10:41 AM
    Total number of users = 3,  number of processes = 10

 Username     Node     Interactive  Subprocess   Batch
 THALES      MILETS            -         -          1
 PRAXITELES  LESBOS            5         2
 PERICLES    ISLAND            1
      

The SHOW USERS command in this example displays the user name and node names of all users whose user names contain the string LES.

#4

$ SHOW USERS/FULL/NODE=AAAAAA
      OpenVMS User Processes at 9-JUN-2001 02:23 PM
    Total number of users = 3,  number of processes = 3
 Username    Node   Process Name    PID     Terminal
 DJONES     AAAAAA  Aaaaaa_fta2:  2180012D  FTA2:
 DYSLI      AAAAAA  DYSLI         2180011A  FTA1:
 SINDBY     AAAAAA  SINDBY        2180011E  RTA1:   (JJJJJ::SINDBY)
<LOGIN> B4B4    _WSA1         3100009F

      

The SHOW USERS command in this example displays the user name, the local node, the process name, the process identification (PID) number, the terminal names (both virtual and physical), and port information for all interactive, subprocess, and batch users on system AAAAAA. A user name of <LOGIN> indicates that someone is in the process of logging in.

#5

$ SHOW USERS /NODE=(AAAAAA,BBBBBB,MMMMMM)
      OpenVMS User Processes at 9-JUN-2001 02:23 PM
    Total number of users = 5,  number of processes = 7
 Username    Node   Process Name    PID     Terminal
 BRICKLEY   BBBBBB  BRICKLEY      21E0009E  RTA1:  (CBREEZ::BRICKLEY)
 DCLDCT     MMMMMM  Mmmmmm_rta1:  2020015D  RTA1:  (MMMMMM::DJOHNSON)
 SMITH      AAAAAA  Aaaaaa_fta2:  2180012D  FTA2:
 PETERSON   MMMMMM  Mmmmmm_fta1:  2020013E  FTA1:
 PRESTON    MMMMMM  Mmmmmm_rta3:  20200184  RTA3:  (DDRSND::PRESTON)
 PRUSS      AAAAAA  PRUSS         2180011E  RTA1:  (IVOK::PRUSS)
 RABAHY     AAAAAA  RABAHY        2180011A  FTA1:
      

The SHOW USERS command in this example displays the user name and node name for all interactive, batch, and subprocess users on the nodes AAAAAA, BBBBBB, and MMMMMM.


Previous Next Contents Index