.lm0.rm74
1##XSHOW
.br
##An eXtended SHOW utility.
.sk1
##Format:
.sk2
##XSHOW option[/qualifier,...]
.br
2##DEVICE
.sk1
#Shows open files on a disk on a cluster wide basis.
.sk2
##Format:#XSHOW#DEVICE##device-name[:]
.br
3##Parameter
.br
#Device-name
.sk1
.lm+2
Requires SYSPRV, READALL, or BYPASS privileges to list read-protected files.
.sk1
Displays a cluster-wide list of the names of all the files open on a
device and their associated process name and process identification
(PID).  The specified device must be a mounted Files-11 device.
.sk1
Note that the XSHOW DEVICE command does not support defaults
for nonspecified portions of device names.  You must supply a
complete device specification.
.sk1
If the /SYSTEM qualifier is also specified, only the names of
installed files and files opened by the system are displayed.  Files
opened by the system are those which have been opened without the
use of an ancillary control process (ACP), such as INDEXF.SYS and
QUOTA.SYS, as well as system files such as JBCSYSQUE.EXE and
SYSMSG.EXE.
.sk1
If the /NOSYSTEM qualifier is specified, only those files opened by
processes are displayed.
.sk1
If neither the /SYSTEM nor /NOSYSTEM qualifier is specified, the
names of all files currently opened on the system are displayed.
.sk1
If a file is read-protected from your UIC, the "No privilege"
message is displayed instead of the file name.  You must have SYSPRV
(system privilege), READALL or BYPASS privilege in order to display the file
name.
.sk1
A space in place of a file name represents a workfile (such as a
temporary edit file) not entered in any directory.  In order to have
temporary file names displayed, you must have BYPASS or READALL privilege in
addition to GROUP or WORLD privilege.
.sk1
The message "no such file" indicates the file has been deleted since
the last snapshot of the disk was taken.  Chances are that the file
is no longer open on the specified device.
.lm-2
.br
3##Command__Qualifiers
.sk1
/CPU
.br
#/CPU=(Cpu-identifier[,...])
.sk1
.lm+2
Selects one or more CPUs for consideration when looking for objects
to display.
.sk1
If no CPU is requested information for all available systems is displayed.
.lm-2
/SYSTEM
.sk1
#/SYSTEM
.br
#/NOSYSTEM
.sk1
.lm+2
If the /SYSTEM qualifier is specified, only the names of
installed files and files opened by the system are displayed.  Files
opened by the system are those which have been opened without the
use of an ancillary control process (ACP), such as INDEXF.SYS and
QUOTA.SYS, as well as system files such as JBCSYSQUE.EXE and
SYSMSG.EXE.
.sk1
If the /NOSYSTEM qualifier is specified, only those files opened by
processes are displayed.
.sk1
If neither the /SYSTEM nor /NOSYSTEM qualifier is specified, the
names of all files currently opened on the system are displayed.
.lm-2
.br
2##HOLDERS
.sk1
Shows the holders of an identifier.
.sk2
##Format:#XSHOW#HOLDERS##identifier
.br
3##Parameter
.br
Identifier
.lm+2
The name of an identifier in the rights database.  All the holders of
this identifier will be displayed.
.lm-2
2##IDENTIFIERS
.sk1
Shows identifiers in the rightslist which match the supplied pattern string.
.sk2
##Format:#XSHOW#IDENTIFIERS#pattern-string
.br
3##Parameter
.br
Pattern-String
.sk1
.lm+2
The name of an identifier to look up in the rightslist database.
Pattern-String may contain standard VMS wildcards (_* and _%).
.lm-2
.if HBO
2##PRIVILEGES
.sk1
#Shows names of products a user is authorized to run.
.sk2
##Format:#XSHOW#PRIVILEGES##[process-name]
.br
3##Parameter
.br
#Process-name
.sk1
.lm+2
Specifies the name of the process about which information is  to  be
displayed.   Process  names  can  have  from  1  to  15 alphanumeric
characters.   Process  names  are  linked  to  group  numbers.   The
specified  process  must  have  the  same  group  number in its user
identification code  (UIC)  as  the  current  process.   You  cannot
specify  the  process  name for a process outside of your group.  To
display information about a process outside of your group, you  must
use the qualifier /IDENTIFICATION=PID.
.sk1
You cannot use the process name parameter when  the  /IDENTIFICATION
qualifier is specified.  If you include neither the process name nor
the /IDENTIFICATION qualifier, the current process is assumed.
.lm-2
.br
3##Command__Qualifier
.br
/IDENTIFICATION
.br
#/IDENTIFICATION=Pid
.br
#Process ID of the process you wish to obtain information on.
.br
.endif HBO
2##TERMINAL
.sk1
.lm+2
Displays, for a LAT (LTAnnnn) terminal, the DECserver, the DECserver
port, and the session number.
.lm-2
.sk2
##Format:#XSHOW TERMINAL LTAnnnn[:]
.br
3##Parameter
.sk1
#LTAnnnn
.sk1
##The specific LAT terminal you wish to obtain information on.
.br
2##USERS
.sk1
#Displays information about processes on nodes in a cluster.
.sk2
##Format:#XSHOW USERS##[username]
.br
3##Parameter
.sk1
#Username
.sk1
.lm+2
Specifies the user about whom you want information.  If you
specify a string, the system lists processes whose usernames
begin with the specified character string.  For example, if the
string MAR is specified as a username, a list of processes whose
usernames begin with MAR are displayed. 
.lm-2
3##Command__Qualifiers
.sk1
/ALL__CPUS
.sk1
#/ALL__CPUS
.sk1
#Displays information from all CPUs.
.sk1
/BATCH
.sk1
#/BATCH
.sk1
#Displays information about batch jobs.
.sk1
/CPU
.br
#/CPU=(Cpu-identifier[,...])
.sk1
.lm+2
Selects one or more CPUs for consideration when looking for objects
to display.
.sk1
If no CPU is requested information from the current CPU is displayed.
.lm-2
.sk1
/DETACHED
.sk1
#/DETACHED
.sk1
#Displays information about detached processes.
.sk1
/FULL
.sk1
#/FULL
.sk1
#Displays Elapsed CPU time and Connect time.
.sk1
/GRAND__TOTAL
.sk1
#/GRAND__TOTAL=option
.br
#/NOGRAND__TOTAL
.sk1
#Selects the type of display to generate for the Grand__Total line.
.sk1
.i5;ALPHANUMERIC####Selects an alphanumeric field display.  Output would
.i5;################look like the following:
.sk1
.i5;################Grand Total of 12/34 processes displayed/considered
.sk1
.i5;NUMERIC#########Selects a numeric field display.  Output would
.i5;################look like the following:
.i5;################12,34
.sk1
.i5;################This format would be useful in conjunction with
.i5;################/NOTEXT for data gathering purposes.
.sk1
#/NOGRAND__TOTAL supresses output of Grand__Total displays.
.sk1
#/GRAND__TOTAL=ALPHANUMERIC is the default.
.sk1
/INTERACTIVE
.sk1
#/INTERACTIVE
.sk1
#Displays information about interactive processes.
.sk1
#/INTERACTIVE is the default.
.sk1
/NETWORK
.sk1
#/NETWORK
.sk1
#Displays information about network processes.
.sk1
/OUTPUT
.sk1
#/OUTPUT=file-spec
.sk1
.lm+2
Controls where the output of the command is sent.  If you do not
enter the qualifier the output is sent to the current process 
default output stream or device, identified by the logical name
SYS$OUTPUT. 
.sk1
If you enter /OUTPUT with a partial file specification (for example,
/OUTPUT=[JONES]), SYSOUTPUT is the default file name and .DAT the
default file type.  If you enter a file specification, it  may  not
include any wildcard characters.
.lm-2
.sk1
/SUBPROCESS
.sk1
#/SUBPROCESS
.sk1
#Displays information about subprocesses.
.sk1
/TERMINAL
.br
#/TERMINAL=terminal
.br
#/NOTERMINAL
.sk1
.lm+2
.i-1;Specifies the terminal for which you want information.  If you
specify a  string, the system lists terminals whose physical name
begins with the specified character string.  For example, if the
string LTA is  specified  as a terminal, a list of terminals
whose physical names begin with LTA is displayed. 
.sk1
.i-1;/NOTERMINAL will list processes which have no associated physical
terminal (i.e. Disconnected, interactive processes and all
non-interactive processes meet this criteria).
.lm-2
.sk1
/TEXT
.sk1
#/TEXT
.br
#/NOTEXT
.sk1
.lm+2
Determines if the textual portion of the XSHOW USERS display is output.
/NOTEXT supresses textual output leaving only the Total and Grand__Total
displays.
.sk1
/TEXT is the default.
.lm-2
.sk1
/TOTAL
.sk1
#/TOTAL=option
.br
#/NOTOTAL
.sk1
#Selects the type of display to generate for the Total line.
.sk1
.i5;ALPHANUMERIC####Selects an alphanumeric field display.  Output would
.i5;################look like the following:
.sk1
.i5;################Total of 12/34 processes displayed/considered
.sk1
.i5;NUMERIC#########Selects a numeric field display.  Output would
.i5;################look like the following:
.i5;################12,34
.sk1
.i5;################This format would be useful in conjunction with
.i5;################/NOTEXT for data gathering purposes.
.sk1
#/NOTOTAL supresses output of Total displays.
.sk1
#/TOTAL=ALPHANUMERIC is the default.