1 SHOW
! ECO02 CWH0005 14-FEB-1983  CW Hobbs
!	MODULE: Show
!		Clarify that SHOW QUOTA /USER requires a value.
! ECO01 CWH0004 06-JUL-1982  CW Hobbs
!	MODULE: Show
!		Add qualifiers to SHOW SYSTEM
! RIT01 AWP001  15-MAR-1983  AW Potter
!       MODULE: Show
!               Add SHOW REMOTE
!
 Displays information about the current  status  of  the  process,  the
 system, or devices in the system.

 Format:

      SHOW    option
2 DAYTIME
 Displays the current date and time in the default output stream.

 Format:

      SHOW [DAY]TIME
2 DEFAULT
 Displays  the  current  default  device  and  directory  name.   These
 defaults  are applied whenever you omit a device and/or directory name
 from a file specification.

 Format:

      SHOW DEFAULT
2 DEVICES
 Displays the status of all devices in the  system,  the  status  of  a
 particular  device,  or  lists the devices that currently have volumes
 mounted on them and/or are allocated to processes.

 Format:

      SHOW DEVICES    [device-name[:]]
3 Parameters
 device-name[:]

  Specifies the name of a device for which  information  is  to  be
  displayed.   You  can  specify  a  complete device name or only a
  portion of a device name.

  If you specify the SHOW DEVICES command  and  specify  neither  a
  device  name  parameter nor any qualifier, the command provides a
  brief listing of characteristics of all devices  in  the  system.
  To obtain information about a specific device or generic class of
  devices, specify a device name.

  Use the /ALLOCATED or /MOUNTED qualifier for a  list  of  devices
  that   are   currently   allocated   to   processes  or  mounted,
  respectively.
3 Qualifiers
/ALLOCATED

 Requests  a  display  of  all  devices  currently  allocated   to
 processes.

 If you specify a device name, the characteristics  of  only  that
 device  are displayed;  if the device is not currently allocated,
 the command displays a message indicating that there is  no  such
 device.    If   you   specify   a   generic   device   name,  the
 characteristics  of  all  allocated  devices  of  that  type  are
 displayed.
/BRIEF

 Requests a brief  display  of  information  about  the  device(s)
 specified.  This is the default.
/FILES

 Requests a list of the names of all files open on a volume.   The
 specified  device  must  be  a  mounted  Files-11 volume.  If the
 specified volume is a multivolume set, the files on  each  volume
 in the set are listed.

 If a file is  read-protected  from  your  UIC,  the  message  "No
 privilege"  is displayed instead of the file name.  You must have
 SYSPRV or BYPASS privilege in order to display the file name.

 Do not use this qualifier with the /ALLOCATED, /BRIEF, /FULL,  or
 /MOUNTED   qualifiers.    The   functions  of  /FILES  and  these
 qualifiers are mutually exclusive.

 More information is displayed when the /SYSTEM qualifier is also
 specified.  See HELP on SHOW DEVICES /SYSTEM.
/FULL

 Requests a complete listing of information about the device(s).
/MOUNTED

 Requests a display of all devices  that  currently  have  volumes
 mounted on them.

 If you specify a device name, only the  characteristics  of  that
 device  are  displayed;   however, if the device is not currently
 mounted, the command issues a message indicating there is no such
 device.    If   you   specify   a   generic   device   name,  the
 characteristics of all devices of that type that  currently  have
 volumes mounted are displayed.
/SYSTEM

   /SYSTEM
   /NOSYSTEM

 Controls whether the names of installed files and files opened by
 the  system  are displayed.  Files opened by the system are files
 opened without  the  use  of  an  ACP,  such  as  INDEXF.SYS  and
 QUOTA.SYS.

 If you specify /NOSYSTEM with the /FILES  qualifier,  only  files
 opened  by a process are displayed.  If you omit both /SYSTEM and
 /NOSYSTEM and specify the /FILES  qualifier,  the  names  of  all
 files currently opened on the system are displayed.

 You can only use this qualifier with the /FILES  qualifier.   See
 the /FILES description for more details.
2 ERROR
 Displays the error count for the CPU, memory, and all physical devices
 with error counts greater than 0.

 Format:

      SHOW ERROR
3 Qualifier
/FULL

 Displays the error count for CPU, memory, and all physical devices
 including terminals.
2 LOGICAL
 Displays  all logical  names in  one or more logical name tables;
 or displays the current equivalence name assigned  to a specified
 logical name by the ASSIGN, ALLOCATE, DEFINE, or MOUNT command.

 Format:

      SHOW LOGICAL    [logical-name[:]]
3 Parameters
 logical-name[:]

  Specifies a 1- through 63-alphanumeric character logical name for
  which  the equivalence name is to be displayed.  The logical name
  is translated recursively  a  maximum  of  10  times.   For  each
  translation,  the  process, group, and system logical name tables
  are searched, in that order, and the  equivalence  name  for  the
  first match found is displayed.

  If you do not specify a logical name, the  command  displays  all
  logical names in one or more tables, based on the presence of the
  /PROCESS, /GROUP, or /SYSTEM qualifiers.  If  no  qualifiers  are
  present  and  no  logical name is specified, the command displays
  all logical names in all logical name tables.

  Wild card characters are allowed in the logical name.
3 Qualifiers
/ALL

 Specifies that all logical names in the  specified  logical  name
 table(s)  be  displayed.   If  none  of  the qualifiers /PROCESS,
 /GROUP, or /SYSTEM is specified, all names in  all  logical  name
 tables are displayed.  This is the default.
/GROUP

 Indicates, when a logical-name parameter is  present,  that  only
 the group logical name table is to be searched.

 If you specify /ALL either explicitly or by default, all  entries
 in the group logical name table are displayed.
/PROCESS

 Indicates, when a logical-name parameter is specified, that  only
 the process logical name table is to be searched.

 If you specify /ALL either explicitly or by default, all  entries
 in the process logical name table are displayed.
/SYSTEM

 Indicates, when a logical-name parameter is  present,  that  only
 the system logical name table is to be searched.

 If you specify /ALL either explicitly or by default, all names in
 the system logical name table are displayed.
2 MAGTAPE
 Displays  the  current  characteristics  and  status  of  a  specified
 magnetic tape device.

 Format:

      SHOW MAGTAPE    device-name[:]
3 Parameters
 device-name[:]

  Specifies the name of the magnetic tape device for which you want
  to display the characteristics and status.
2 MEMORY
 Displays the availability and  utilization  of  the  following  memory
 resources:

      o  Physical memory
      o  Process entry slots and balance set slots
      o  Paged and nonpaged dynamic pools
      o  Paging files
      o  Swapping files

 Format:

      SHOW MEMORY
3 Qualifiers
/ALL

 Displays  all  available  information,   that   is,   information
 displayed  by  the  /FILES,  /PHYSICAL_PAGES,  /POOL,  and /SLOTS
 qualifiers.  By default, all available information is displayed.
/FILES

 Displays information about the usage of each paging and swap file
 currently installed.
/FULL

 When used with the /POOL or /FILES qualifier, displays additional
 information  about the usage of each pool area or paging and swap
 file currently installed.  This qualifier is ignored  unless  the
 /FILES or /POOL qualifier is explicitly specified.
/PHYSICAL_PAGES

 Displays information about the amount of physical memory and  the
 number of free and modified pages.
/POOL

 Displays information about  the  usage  of  each  dynamic  memory
 (pool)  area,  including the amount of free space and the size of
 the largest contiguous block in each area.
/SLOTS

 Displays information about the availability of PCB  vector  slots
 and balance slots.
2 NETWORK
 Displays the availability of the local node as a member of the network
 and the addresses and names of all nodes that are currently accessible
 to the local node.  The SHOW NETWORK command also  displays  link  and
 cost  relationships  between  the  local  node  and other nodes in the
 network.

 The  DECNet-VAX software  is  optional  and  available under  separate
 license.

 Format:

      SHOW NETWORK
2 PRINTER
 Displays the default characteristics currently defined  for  a  system
 printer.

 Format:

      SHOW PRINTER  device-name[:]
3 Parameters
 device-name[:]

  Specifies the name of the printer for which  characteristics  are
  to be displayed.
2 PROCESS
 Displays information about a process and any subprocess in the current
 process tree.

 Format:

      SHOW PROCESS [process-name]
3 Parameters
 process-name

  Specifies a 1-through 15-character alphanumeric  string  name  of
  the  process about which information is to be displayed.  You can
  specify the name of a process that has the same group UIC, as the
  current process, provided you have GROUP privilege.

  You cannot use this parameter if the /ID qualifier is specified.
3 Qualifiers
/ACCOUNTING

 Displays  accumulated  accounting  statistics  for  the   current
 terminal session.
/ALL

 Displays  all  information  available,  that  is,   the   default
 information   as   well  as  the  information  displayed  by  the
 /ACCOUNTING,  /MEMORY,  /PRIVILEGES,  /QUOTAS, and  /SUBPROCESSES
 qualifiers.
/CONTINUOUS

 Displays continuously updated information about the process.  You
 need GROUP or WORLD privilege to examine other processes.

 While the continuous display is running, you can press the V  key
 to display a map of the pages in the virtual address space of the
 process.  Valid pages in the working set are  represented  by  an
 asterisk  (*);   the current PC is represented by an at sign (@).
 Pages locked  in memory appear as L's,  global pages as G's.   To
 return to the original display, press the space bar.

 To terminate the continuous display, press E, CTRL/Z, or CTRL/Y.
/ID

   /ID=process-id

 Specifies the process identification (PID) of the  process  about
 which information is to be displayed.  The PID is assigned by the
 system when the process is created.  When you specify a PID,  you
 can omit the leading zeros.

 If you specify the /ID qualifier you cannot use the process  name
 parameter.   GROUP  or  WORLD  privilege  is  required to display
 information about a process other than the current process.
/MEMORY

 Displays the process's use of dynamic memory  areas  consisting  of
 variably sized blocks.
/PRIVILEGES

 Displays the user privileges that are currently enabled  for  the
 process.
/QUOTAS

 Displays the process's  current  quotas.   The  values  displayed
 reflect any quota reductions resulting from subprocess creation.
/SUBPROCESSES

 Displays the process name(s) of any  subprocesses  owned  by  the
 current  process;   if  a  hierarchy  of subprocesses exists, the
 command displays the names in hierarchical order.  This qualifier
 can only be used for the current process.

 You cannot use  this  qualifier  with  the  /ID qualifier.   The
 functions  of  this  qualifier and the /ID qualifier are mutually
 exclusive.
2 PROTECTION
 Displays the current file protection to be applied to  all  new  files
 created  during the terminal session or batch job.  You can change the
 default protection at any time with the SET PROTECTION command.

 Format:

      SHOW PROTECTION
2 QUEUE
 Displays the current status of entries in the print and/or  batch  job
 queues.

 Format:

      SHOW QUEUE [queue-name[:]]
3 Parameters
 queue-name[:]

  Specifies  the  name  of  a  queue  you  want  to  display.   The
  queue-name  parameter  is  required  if you do not specify either
  /BATCH or /DEVICE.
3 Qualifiers
/ALL

 Displays the names of  all  jobs  in  the  specified  queue.   By
 default,  the  SHOW QUEUE  command displays only current jobs and
 pending jobs owned by the current process.
/BATCH

 Displays entries in all batch job queues.
/BRIEF

 Requests a brief listing of information about jobs in the  queue.
 When you specify /BRIEF, only the user name, job number and queue
 name are displayed.
/DEVICE

 Displays the status of jobs in all device queues.
/FULL

 Displays the file specifications of each file in each pending job
 in the queue.
2 QUOTA
 Displays the current disk quota that is authorized to and  used  by  a
 specific  user  on  a  specific  disk.   This  display also includes a
 calculation of the  amount  of  space  available  and  the  amount  of
 overdraft that is permitted.

 Format:

      SHOW QUOTA
3 Qualifiers
/DISK

   /DISK[=device-name[:]]

 Identifies the disk whose quotas are to be examined.  By default,
 SYS$DISK, the current default disk is examined.
/USER

   /USER=uic

 Identifies which user's quotas are to  be  displayed.   The  user
 identification  code  (UIC)  must be specified in square brackets
 ([ ]), with the group and member numbers separated by commas.

 If you omit this qualifier, by default your own  disk quotas  are
 displayed.
2 REMOTE 
 (RIT supported command)

 Displays  information  on one or more  remote DECnet  nodes.  You
 must supply one or more items to be shown and at least one remote
 DECnet node. Some of the  items supported  on the RIT network are
 USERS, PRINTERS, BATCH, and SYSTEM. The item and node  specifiers
 must entered completely.
 
 Format:
     
     SHOW REMOTE item[,item...]  node[,node...]
3 Examples
 $ SHOW REMOTE USERS VAXA::  

     Lists the users logged on to VAXA::


 $ SHOW REMOTE BATCH,PRINTERS VAXA::,VAXC::

     Displays Batch and Print queue status on VAXA and VAXC     
2 RMS_DEFAULT
 Displays the current default multiblock count, multibuffer  count,
 extend quantity, and prologue that VAX-11 RMS uses for file operations.

 Format:

      SHOW RMS_DEFAULT
2 STATUS
 Displays the status  of  the  process  while  an  image  is  currently
 executing in the process.  The SHOW STATUS command does not affect the
 image;  you can continue the execution of the image  after  displaying
 the status of the process.

 Format:

      SHOW STATUS
2 SYMBOL
 Displays the current value of a local or global symbol.   Symbols  are
 defined  with  assignment  statements  (the  =  command),  by  passing
 parameters to a command procedure file, or by the  INQUIRE,  READ,  or
 WRITE command.

 Format:

      SHOW SYMBOL  [symbol-name]
3 Parameters
 symbol-name

  Specifies the 1- through 255-alphanumeric character name  of  the
  symbol  whose  value  you  want to display.  The symbol-name must
  begin with an alphabetic  character.   The  SHOW  SYMBOL  command
  searches  the  local  symbol table for the current command level,
  then local symbol tables for preceding command levels,  then  the
  global  symbol  table  for the specified symbol, and displays the
  first match it finds.

  If you specify /ALL, you cannot specify a symbol name.
3 Qualifiers
/ALL

 Requests that the current values of all symbols in the  specified
 symbol  table  be  displayed.   If  you  specify  /ALL and do not
 specify  either  /LOCAL  or  /GLOBAL,  the  SHOW  SYMBOL  command
 displays  the  contents of the local symbol table for the current
 command level.
/GLOBAL

 Requests that only the global symbol table be  searched  for  the
 specified symbol name.

 If you specify /ALL, all names in the  global  symbol  table  are
 displayed.
/LOCAL

 Requests that only the local symbol table for the current command
 level be searched for the specified symbol name.

 If you specify /ALL, all names in the local symbol table for  the
 current command level are displayed.
2 SYSTEM
 Displays a list of processes in the system and information  about  the
 status of each.

 Format:

      SHOW SYSTEM
3 Qualifiers
/BATCH

 Requests the display of the batch jobs in the system.
/NETWORK

 Requests the display of all the network processes in the system.
/PROCESS

 Requests the  display of  all processes  in the  system.   This is the
 default.
/SUBPROCESS

 Requests the display of the subprocesses in the system.
2 TERMINAL
 Displays the current characteristics of a specific terminal.  Each  of
 these  characteristics  can  be changed with a corresponding option of
 the SET TERMINAL command.

 Format:

      SHOW TERMINAL  [device-name[:]]
3 Parameters
 device-name[:]

  Specifies  the  name  of  a  terminal  for  which  you  want  the
  characteristics  displayed.  If you do not specify a device name,
  the characteristics of the current device assigned to the logical
  name SYS$COMMAND are displayed.
3 Qualifiers
/PERMANENT

 Displays the current permanent characteristics of  the  specified
 terminal.

 You must have the LOG_IO or PHY_IO  user  privilege  to  use  the
 /PERMANENT qualifier.
2 TIME
 Displays the current date and time in the default output stream.

 Format:

      SHOW [DAY]TIME
2 TRANSLATION
 Searches the process, group, and system logical name tables,  in  that
 order,  for  a specified logical name and returns the equivalence name
 of the first match found.

 Format:

      SHOW TRANSLATION  logical-name
3 Parameters
 logical-name

  Specifies a 1- through 63-alphanumeric character logical name for
  which  you  want  to display the translation.  The translation is
  not recursive.
2 USERS
 Displays the terminal  name,  username,  and  process-id  of  specific
 interactive users, or of all interactive users on the system.

 Format:

      SHOW USERS [username]
3 Parameters
 username

  Specifies that a list of all  interactive  users  whose  username
  begins  with  the  specified  character string is displayed.  For
  example, if the string MAR is specified as a username, a list  of
  all   interactive   users  whose  username  begins  with  MAR  is
  displayed.   If  no  user  exists  whose  username  matches   the
  specified  username  string,  only a message indicating the total
  number of interactive users is displayed.

  If you omit this parameter, a list of all  interactive  users  is
  displayed.
2 WORKING_SET
 Displays the working set quota  and  limit  assigned  to  the  current
 process.

 Format:

      SHOW WORKING_SET
