Establishes values or context for subsequent commands or action.
1 – CPU
When analyzing a system dump, selects a processor to become the
current CPU for SDA. When invoked under ANALYZE/SYSTEM, SET CPU
lists the database address for the specified CPU before exiting
with the message:
%SDA-E-CMDNOTVLD command not valid on the running system
Format
SET CPU {cpu-id | /FIRST | /NEXT | /PRIMARY } [/NOLOG]
1.1 – Parameter
cpu-id
Numeric value indicating the identity of the processor to be made
the current CPU. If you specify the cpu-id of a processor that
was not active at the time of the system failure, SDA displays
the following message:
%SDA-E-CPUNOTVLD, CPU not booted or CPU number out of range
1.2 – Qualifiers
1.2.1 /FIRST
The lowest numbered CPU (not necessarily the primary CPU) is
set as the current CPU.
1.2.2 /NEXT
The next higher numbered CPU is set as the current CPU. SDA
skips CPUs not in the configuration at the time of the system
failure. If there are no further CPUs, SDA returns an error.
1.2.3 /NOLOG
Use the /NOLOG qualifier to inhibit output of the database
address for the CPU being set.
1.2.4 /PRIMARY
The primary CPU is set as the current CPU.
2 – ERASE_SCREEN
Enables or disables the automatic clearing of the screen before
each new page of SDA output.
Format
SET ERASE_SCREEN {ON | OFF}
2.1 – Parameters
ON
Enables the screen to be erased before SDA outputs a new heading.
This setting is the default.
OFF
Disables the erasing of the screen.
3 – FETCH
Sets the default size and access method of address data used when
SDA evaluates an expression that includes the @ unary operator.
Format
SET FETCH [{QUADWORD | LONGWORD | WORD | BYTE}]
[, {PHYSICAL | VIRTUAL} ]
3.1 – Parameters
QUADWORD
Sets the default size to 8 bytes.
LONGWORD
Sets the default size to 4 bytes.
WORD
Sets the default size to 2 bytes.
BYTE
Sets the default size to 1 byte.
PHYSICAL
Sets the default access method to physical addresses.
VIRTUAL
Sets the default access method to virtual addresses.
You can specify only one parameter out of each group. If you are
changing both size and access method, separate the two parameters
by spaces or a comma. Include a comma only if you are specifying
a parameter from both groups.
4 – LOG
Initiates or discontinues the recording of an SDA session in a
text file.
Format
SET [NO]LOG filespec
4.1 – Parameter
filespec
Name of the file in which you want SDA to log your commands
and their output. The default filespec is SYS$DISK:[default_
dir]filename.LOG, where SYS$DISK and [default-dir] represent
the disk and directory specified in your last DCL command SET
DEFAULT. If you specify SET LOG without a filename or specify SET
NOLOG, SDA stops recording the session and directs all output to
SYS$OUTPUT.
5 – OUTPUT
Redirects output from SDA to the specified file or device.
Format
SET OUTPUT [/[NO]INDEX | /[NO]HEADER | /PERMANENT |
/SINGLE_COMMAND] filespec
5.1 – Parameter
filespec
Name of the file to which SDA is to send the output generated
by its commands. The default filespec is SYS$DISK:[default_dir]
filename.LIS, where SYS$DISK and [default-dir] represent the disk
and directory specified in your last DCL command SET DEFAULT. You
must specify a file name except when /PERMANENT is specified.
5.2 – Qualifiers
5.2.1 /INDEX
/INDEX
/NOINDEX
The /INDEX qualifier causes SDA to include an index page
at the beginning of the output file. This is the default
unless you specify /NOHEADER or modify the default with a SET
OUTPUT/PERMANENT command. The /NOINDEX qualifier causes SDA to
omit the index page from the output file.
5.2.2 /HEADER
/HEADER
/NOHEADER
The /HEADER qualifier causes SDA to include a heading at the
top of each page of the output file. This is the default unless
you modify it with a SET OUTPUT/PERMANENT command. The /NOHEADER
qualifier causes SDA to omit the page headings. Use of /NOHEADER
implies /NOINDEX.
5.2.3 /PERMANENT
Modifies the defaults for /[NO]HEADER and /[NO]INDEX. Specify
either or both qualifiers with or without a NO prefix to set new
defaults. Setting the default to /NOHEADER implies a default of
/NOINDEX. The new defaults remain in effect until another SET
OUTPUT/PERMANENT command is entered or the SDA session is ended.
You cannot combine /PERMANENT and /SINGLE_COMMAND in one command,
and you cannot provide a filespec with /PERMANENT.
5.2.4 /SINGLE_COMMAND
Indicates to SDA that the output for a single command is to be
written to the specified file and that subsequent output should
be written to the terminal. /SINGLE_COMMAND cannot be combined
with /PERMANENT.
6 – PROCESS
Selects a process to become the SDA current process.
Format
SET PROCESS {/ADDRESS=pcb-address | process-name | /ID=nn
| /INDEX=nn | /NEXT | /SYSTEM}
6.1 – Parameter
process-name
Name of the process to become the SDA current process. The
process-name can contain up to 15 uppercase letters, numerals,
the underscore (_), dollar sign ($), colon (:), and some other
printable characters. If it contains any other characters
(including lowercase letters), you may need to enclose the
process-name in quotation marks (" ").
6.2 – Qualifiers
6.2.1 /ADDRESS
/ADDRESS = pcb-address
Specifies the process control block (PCB) address of a process in
order to display information about the process.
6.2.2 /ID
/ID=nn
See the description of /INDEX, which is functionally equivalent
to /ID.
6.2.3 /INDEX
/INDEX=nn
Specifies the process for which information is to be displayed
either by its index into the system's list of software process
control blocks (PCBs), or by its process identification. /ID and
/INDEX are functionally equivalent. You can supply the following
values for nn:
o The process index itself.
o The process identification (PID) or extended PID longword,
from which SDA extracts the correct index. The PID or extended
PID of any thread of a process with multiple kernel threads
may be specified. Any thread-specific data displayed by
further commands will be for the given thread.
To obtain these values for any given process, issue the SDA
command SHOW SUMMARY/THREADS. The /ID=nn and /INDEX=nn qualifiers
can be used interchangeably.
6.2.4 /NEXT
Causes SDA to locate the next valid process in the process list
and select that process. If there are no further valid processes
in the process list, SDA returns an error.
6.2.5 /SYSTEM
Specifies the new current process by the system process control
block (PCB). The system PCB and process header (PHD) parallel the
data structures that describe processes. They contain the system
working set list, global section table, and other systemwide
data.
7 – RMS
Changes the options shown by the SHOW PROCESS/RMS command.
Format
SET RMS = (option[,...])
7.1 – Parameter
option
Data structure or other information to be displayed by the
SHOW PROCESS/RMS command. The following keywords can be used
as options.
Keyword Meaning
[NO]ALL[:ifi] All control blocks (default)
[NO]ASB Asynchronous context block
[NO]BDB Buffer descriptor block
[NO]BDBSUM BDB summary page
[NO]BLB Buffer lock block
[NO]BLBSUM Buffer lock summary page
[NO]CCB Channel control block
[NO]DRC Directory cache
[NO]FAB File attributes block
[NO]FCB File control block
[NO]FWA File work area
[NO]GBD Global buffer descriptor
[NO]GBDSUM GBD summary page
[NO]GBH Global buffer header
[NO]GBSB Global buffer synchronization block
[NO]IDX Index descriptor
[NO]IFAB[:ifi] Internal FAB
[NO]IFB[:ifi] Internal FAB
[NO]IRAB Internal RAB
[NO]IRB Internal RAB
[NO]JFB Journaling file block
[NO]NAM Name block
[NO]NWA Network work area
[NO]PIO Image I/O (NOPIO), the default, or process I/O
(PIO)
[NO]RAB Record attributes block
[NO]RLB Record lock block
[NO]RU Recovery unit structures, including the recovery
unit block (RUB), recovery unit stream block
(RUSB), and recovery unit file block (RUFB)
[NO]SFSB Shared file synchronization block
[NO]WCB Window control block
[NO]XAB Extended attribute block
[NO]* Current list of options displayed by the SHOW RMS
command
8 – SIGN_EXTEND
Enables or disables the sign extension of 32-bit addresses.
Format
SET SIGN_EXTEND {ON | OFF}
8.1 – Parameters
ON
Enables automatic sign extension of 32-bit addresses with bit 31
set. This is the default.
OFF
Disables automatic sign extension of 32-bit addresses with bit 31
set.
9 – SYMBOLIZE
Enables or disables symbolization of addresses in the display
from an EXAMINE command.
Format
SET SYMBOLIZE {ON | OFF}
9.1 – Parameters
ON
Enables symbolization of addresses.
OFF
Disables symbolization of addresses.