LIST subcommand — display storage

Use the LIST subcommand to display storage from the current dump. You can display storage from one or several dump locations. Specify the amount of storage and its format with the appropriate data description parameters.

• Related subcommands
  • EQUATE
  • FIND
  • FINDMOD
  • FINDUCB
  • LISTMAP
  • LISTSYM
  • STATUS
• Syntax

   { LIST }     { data-descr      }
   { L    }     { (data-descr...) }

  -------- SETDEF-Defined Parameters -------------------------
  Note: You can override the following SETDEF parameters.
  See SETDEF subcommand — set defaults.

                [ DISPLAY[(display-options)]   ]
                [ NODISPLAY[(display-options)] ]
                [ FLAG(severity) ]
                [ PRINT | NOPRINT ]
                [ TERMINAL | NOTERMINAL ]
                [ TEST | NOTEST ]

• Parameters

  data-descr or (data-descr...)

  Specifies that either one data description or a list of data descriptions be entered. A list of data descriptions consists of multiple address expressions and one group of data description parameters that apply to all addresses in the list. The data description parameter consists of five parts:

  • An address (required)
  • Address processing parameters (optional)
  • An attribute parameter (optional)
  • Array parameters (optional)
  • A remark parameter (optional)

  Data description parameter explains the use and syntax of the data description parameter.

  Use the following data description parameters to obtain particular information:

  • TITLE to obtain the title of an SVC dump.
  • COMPDATA(IEASLIP) to obtain the SLIP command parameters in EBCDIC for an SVC dump requested by a SLIP command. If the SLIP command parameters are not available, the following appears:

    SLIP TRAP TEXT NOT AVAILABLE

  DISPLAY[(display-options)]

  NODISPLAY[(nodisplay-options)]

  Specifies if IPCS is to display or not display the storage identified in the data-descr parameter. For the LIST subcommand, the default is DISPLAY(STORAGE). See the SETDEF subcommand for other values for DISPLAY.

• Return Codes

  See Standard subcommand return codes for a description of the return codes produced by the LIST subcommand.

• Example 1: Display the title of the dump.
  • Action

    COMMAND ===> list title

  • Result

    Using the special symbol TITLE, the LIST subcommand generates the following output, including the dump title, “Hang After Hotstart”. IPCS also displays the dump title during dump initialization.

    TITLE
    LIST 00000000. HEADER POSITION(X'+0020') LENGTH(19) CHARACTER
    00000020. | HANG AFTER HOTSTART                             |

• Example 2: Display all PSAs when running the 3090 model 400.
  • Action

    COMMAND ===> list (psa0, psa1, psa2, psa4) structure(psa)

  • Result

    LIST displays the PSA for each central processor that is online.

• Example 3: Display SQA storage.
  • Action

    COMMAND ===> list sqa

  • Result

    LIST displays SQA storage.

• Example 4: Display multiple system storage areas.
  • Action
    Specify the appropriate symbols with LIST, enclosing them in parentheses:

    COMMAND ===> list (sqa csa private)

  • Result

    LIST displays the storage for the areas.

• Example 5: Display central storage. There are several ways to do this. One way is to request a range of absolute addresses, like this:
  • Action

    COMMAND ===> list 0:7fffffff absolute

  • Result

    LIST displays all of ABSOLUTE storage, without performing storage prefixing.

• Example 6: Another way to display central storage is to request a range of central storage for a given central processor.
  • Action

    COMMAND ===> list 0:7fffffff CPU(0) real

  • Result

    LIST displays the same storage as Example 5, replacing the ABSOLUTE PSA (the storage at 0:0FFF) with the PSA of central processor CPU(0). The ABSOLUTE PSA appears where the PSA for CPU(0) appeared in the Example 5.

    Note: If you want to print the dump quickly, you can break your request into pieces, as shown in the following examples:

    To Get This Result	Make This Request
    Absolute PSA	list 0:0fff absolute
    Real PSAs for each central processor	list 0:0fff cpu(n) real
    Absolute storage above the PSA	list 1000:7fffffff absolute

• Example 7: Display storage in instruction format.
  • Action

    COMMAND ===> list 081A8C14. instruction

  • Result

    LIST 081A8C14. ASID(X'0060') LENGTH(X'1000') INSTRUCTION
         081A8C14 | D203 E000 A01C | MVC   X'0'(X'4',R14),X'1C'(R10)
         081A8C1A | 90FD E004      | STM   R15,R13,X'4'(R14)
         081A8C1E | 58E0 A01C      | L     R14,X'1C'(,R10)
         081A8C22 | E803 B490 B247 | MVCIN X'490'(X'4',R11),X'247'(R11)
         081A8C28 | 5810 B00C      | L     R1,X'C'(,R11)