SHOWALLOCATE


SHOWALLOCATE

      Displays status information about the ALLOCATE command.  (CM)

SYNTAX


STATUS [,listfile]
SHOWALLOCATE [ALLOCATE [,[fileset [,listfile]] ]
AUTO [,[fileset [,listfile]]
ALL [,[fileset [,listfile]]


PARAMETERS


STATUS Request to display a summary of status
information that includes:

o Number of programs allocated
o Size and percentage of utilization of
the following system tables:

Code segment table
Code segment table extension block
table
Loader segment table

ALLOCATE Request to display programs that have been
allocated using the ALLOCATE command
specified by fileset, and the number of
users sharing each program.

AUTO This parameter is not implemented on MPE
XL. For backward compatibility the
syntax is accepted.

Request to display programs that have been
allocated using the AUTOALLOCATE command
specified by fileset, and the number of
users sharing each program.

ALL Request to display all information
provided by parameters: STATUS, ALLOCATE.
Default.

fileset Specifies the set of files to be searched.
Default is @.@.@. This parameter is of the form:

filedesignator[.groupdesignator[.acctdesignator]]

Fileset can be entered in any of the
following formats and may use the wild
card characters, in any order, as replacements.

file.group.account Shows allocated file name in specified
group and account.

file.group Shows files allocated in
specified groups in any account.

file Shows files allocated
specified file name in
any group and any account.

@.group.
account Shows all allocated files in specified
group and account.

@.@.account Shows all allocated files in all groups
in a specified account.

@.@.@. Shows all allocated files in the system.
Default.

@. Shows all allocated files in all groups in
all accounts.

@.group Shows all allocated files in a specified
group in any account.

file.@.account Shows specified allocated files in any
group of a specified account.

NOTE:


The characters @,#, and ? can be used as "wild card"
characters in the fileset parameter. These wild card
characters have the following meaning:

@ Specifies zero or more alphanumeric characters.
# Specifies one numeric character.
? Specifies one alphanumeric character.

The characters can be used as follows:

n@ All files starting with the character n.

@n All files ending with the character n.

n@x All files starting with the character n and
ending with the character x.

n##
..# All files starting with the character n followed
by up to seven digits (useful for listing all
EDIT/3000 temporary files).

?n@ All files whose second character is n.

n? All two-character files starting with the
character n.

?n All two-character files ending with the
character n.

listfile Name of an output file to which all output
is written. When specified, a new ASCII
file with variable length records closed in
permanent domain, user-supplied carriage
control (CCTL), OUT access mode, and EXC
(exclusive access) option.

This parameter may also be a back-reference
file. Default is $STDLIST.



This command generates the status information of the
specified system tables and lists files which are allocated.


EXAMPLE(S)

To display status information for all allocated files in
the system, enter:

SHOWALLOCATE ALLOCATE

ALLOCATED PROGRAMS SHARE COUNT
------------------ -----------
EDITOR.PUB.SYS 0
FCOPY.PUB.SYS 2
LISTDIR5.PUB.SYS 1

NUMBER OF PROGRAMS FOUND = 3

To display status information for all allocated files
starting with a character S in the account named SYS, enter:

SHOWALLOCATE ALLOCATE,S@.@.SYS

ALLOCATED PROGRAMS SHARE COUNT
------------------ -----------
SPOOK5.PUB.SYS............. 1
SLPATCH.PUB.SYS............ 0

NUMBER OF PROGRAMS FOUND = 2

To display summary status information regarding allocation, enter:

SHOWALLOCATE STATUS

AUTOALLOCATE IS NOT IMPLEMENTED ON MPE XL
NUMBER OF PROGRAMS ALLOCATED = 3

ALLOCATED RELATED TABLES SIZE % USED
------------------------ ---- ------
CODE SEGMENT TABLE 191 52
CSTX BLOCK TABLE 144 13
LOADER SEGMENT TABLE 320000 3