Prints information about data structures concerned with the
operation of LES
SHOW ... options ... [ /FULL ] [ /ALL ]
*NOTE*
If a logical LES$SYM is defined (as a directory spec), then
SDA will attempt to read the following symbol table files in
from LES$SYM: on the first execution any show les command :
LES$LES_V30.EXE (relative to the start of the LES image)
LES_SYMBOLS.STB
LES$ACP_CODE.STB
1 – PPI
SHOW PPI (Just produces a list of PPIs)
SHOW PPI ppiname [ /FULL ]
SHOW PPI ppiaddress [ /FULL ]
SHOW PPI [ /ALL ] [ /FULL ]
Displays information about a named PPI or all PPIs.
ppiaddress may be an address or a symbol.
Use of the /FULL qualifier displays information
about the PPI's Ports also.
Useful (?) symbols dynamically created
LES_TABLE,
OWN : pointer to OWN (==Data) block
NAME_TBL
<ppiname>_OWN
<ppiname>_NAME_TBL
$base_<ppiname>
It might be useful to execute any SHOW PPI command at the
beginning of and sda session so that symbols for all ppis'
name tables, own tables and bases get defined as symbols.
With /FULL, or /PORT=Fred, if any ports and cdbs are found,
then a list of CDBs will appear :
LES$NETMAN PPI, address: 803C6360, name table address 80248B88
--------------------------------------------------------------
CDBs connected to REGISTRATION port
1 80398BD0 DEVICE_MANAGE
2 8039FA80 MANAGE
CDB_1 and CDB_2 are dynamically created with values 80398BD0
and 8039FA80 respectively.
1.1 – ppiname
The name of a ppi. Wildcarding (DCL flavour) possible.
1.2 /PORT
The name of a port. Value required. (may be wildcarded)
1.3 /READ
Indicates that the ppi symbol table should be read in from les$sym. The filename used is <ppiname>.stb. This command takes account of whether the ppi is system or process mode, and reads the symbols relative to the correct address.
2 – SYSTEM
SHOW SYSTEM [/FULL]
Displays information about LES queues.
Symbols set up :
LES_TABLE
3 – CDB
SHOW CDB
SHOW CDB <cdbname|cdbaddress>|/ALL [/FULL]
cdbname == <ppiname>.<portname>.<cdbname>
eg. SHOW CDB les$netman.regis*.m?nage
Displays the address of the cdb found if it exists. Wildcards
are allowed at any place in the cdbname string so this provides
a useful method of looking for any named cdb, cdbs on a particular
port or ppi.
A cdb address may be specified instead of the cdbname. No special
qualifiers are required to do this. Symbols may be specified also.
eg. SHOW CDB 802436d0
SHOW CDB CDB_1
(The CLI just assumes that all cdb addresses will be 8 characters
long and start with an 8 so if it sees anything like that it
tries to convert it into hex...)
Symbols of the form CDB_n dynamically created.
3.1 /CONNECTED
SHOW CDB cdbname /CONNECTED
Shows the address of the cdb connected to the cdb specified.
3.2 /ALT
SHOW CDB cdbname /ALT
Shows the address of the ALT cdb connected to the cdb specified.
3.3 /NOFIND
SHOW CDB cdbname /NOFIND
Does not attempt to find the CDB on the CDB queues. Useful to
look at CDB templates.
4 – LPD
SHOW LPD lpdaddress [/FULL]
Provides information about the LPD specified. (Must be specified as
an address)
Symbol LPD created.
5 – STRING
SHOW STRING stringaddress
Displays a les string - as a simplname by default
5.1 /LOCALENTITYNAME
SHOW STRING stringaddress /LOCALENTITYNAME
Display the string at the address given as a localentityname
5.2 /LATIN1STRING
SHOW STRING stringaddress /LATIN1STRING
Display the string at the address given as a latin1string
5.3 /SIMPLENAME
SHOW STRING stringaddress /SIMPLENAME
Display the string at the address given as a simplename (default)
6 – ITEMLIST
SHOW ITEMLIST itemlistaddress Disassembles an itemlist. The item data field is displayed as a hexstring by default
6.1 /HEXSTRING
SHOW ITEMLIST itemlistaddress /HEXSTRING Display the itemlist at the address given as a Hexstring
6.2 /ASCII
Display the itemlist at the address given as ascii text
6.3 /NUMERIC
Display the itemlist at the address given as a hexadecimal value
7 – TRACEBUFFER
SHOW TRACEBUFFER buffername Go through tracebuffers looking for the named tracebuffer eg. SHO TRACEBUFFER *
7.1 /BEFORE
specify a time eg. "17-NOV-1858 00:00"
3/ SINCE
specify a time eg. "17-NOV-1858 00:00"
Displays this help.