1  SET
   Establishes values or context for subsequent commands or action.
 

2  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]
 

3  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
 

3  Qualifiers


/FIRST
   
   The lowest numbered CPU (not necessarily the primary CPU) is 
   set as the current CPU.


/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.

 
/NOLOG

   Use the /NOLOG qualifier to inhibit output of the database 
   address for the CPU being set.


/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}
 

3  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.
 

2  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  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.
 

2  LOG
   Initiates or discontinues the recording of an SDA session in a
   text file.

   Format

     SET [NO]LOG  filespec
 

3  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.
 

2  OUTPUT
   Redirects output from SDA to the specified file or device.

   Format

     SET OUTPUT  [/[NO]INDEX | /[NO]HEADER | /PERMANENT |

                 /SINGLE_COMMAND] filespec
 

3  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.
 

3  Qualifiers
 

/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.
 

/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.
 

/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.
 

/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.
 

2  PROCESS
   Selects a process to become the SDA current process.

   Format

     SET PROCESS  {/ADDRESS=pcb-address | process-name  | /ID=nn

                  | /INDEX=nn  | /NEXT  | /SYSTEM}
 

3  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 (" ").
 

3  Qualifiers
 

/ADDRESS

      /ADDRESS = pcb-address

   Specifies the process control block (PCB) address of a process in
   order to display information about the process.
 

/ID

      /ID=nn

   See the description of /INDEX, which is functionally equivalent
   to /ID.
 

/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.
 

/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.
 

/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.
 

2  RMS
   Changes the options shown by the SHOW PROCESS/RMS command.

   Format

     SET RMS  = (option[,...])
 

3  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
 

2  SIGN_EXTEND
   Enables or disables the sign extension of 32-bit addresses.

   Format

     SET SIGN_EXTEND  {ON | OFF}
 

3  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.
 

2  SYMBOLIZE
   Enables or disables symbolization of addresses in the display
   from an EXAMINE command.

   Format

     SET SYMBOLIZE  {ON | OFF}
 

3  Parameters
 

ON

   Enables symbolization of addresses.
 

OFF

   Disables symbolization of addresses.