LIST CONTAINER command

Displays the contents of a container.

channel_name
The name of the channel that z/OS® Debugger searches through to find a container. If you do not provide a channel name, z/OS Debugger searches through the current channel.
container_name
The name of the container.
index
A decimal or hexadecimal value indicating the location of a single byte in the container to display.
sub_string_start
A decimal or hexadecimal value indicating the starting location of a series of bytes to display.
sub_string_end
A decimal or hexadecimal value indicating the ending location of a series of bytes to display.
sub_string_length
A decimal or hexadecimal value indicating the number of bytes to display.
XML
Indicates that the specified area contains a complete XML 1.0 or 1.1 document. The specified area is passed to the z/OS XML parser for processing. If the parser detects any syntax errors, the error data is shown in the z/OS Debugger log. Otherwise, z/OS Debugger displays a formatted version of the XML document in the z/OS Debugger log.
EBCDIC
Indicates that the specified area contains EBCDIC characters.
ASCII
Indicates that the specified area contains ASCII characters.
CODEPAGE
Indicates that the specified area contains characters in the specified code page.
ccsid
Specifies the Coded Character Set Identifiers used to encode the XML. z/OS Debugger uses the z/OS Unicode Services to convert the characters in the XML from this code page to the code page specified by the EQAOPTS CODEPAGE command before the characters are displayed on the 3270 terminal. The ccsid can be a decimal number in the range 1 to 65535.

Usage notes

  • You can use the LIST CONTAINER command in remote debug mode, except for the XML option.
  • For PL/I, COBOL, LangX COBOL, assembler, and disassembly, if the name is mixed case or case sensitive, you must enclose the name in quotation marks (") or apostrophes (').
  • For C and C++, the name is always treated as case sensitive, even if it is not enclosed in quotation marks (").
  • XML is supported only when you run on z/OS Version 1.8 or later.
  • If you specify XML but not EBCDIC, ASCII, nor CODEPAGE, z/OS Debugger attempts to detect if the encoding of the XML document is EBCDIC or ASCII.
  • Some information in the XML document (for example, most of the DTD specification and some white space) might not be listed because the z/OS XML parser does not return it to z/OS Debugger.

Examples

  • For PL/I, COBOL, LangX COBOL, assembler, or disassembly, enter the following command to display two bytes, starting at the first byte, of container CONNAME, which is in channel CHNAME: 
    LIST CONTAINER CHNAME CONNAME ( 1 :: 2);
  • For PL/I, COBOL, LangX COBOL, assembler, or disassembly, enter the following command to display two bytes, starting at the first byte, of container CONNAME, which is in channel chname: 
    LIST CONTAINER 'chname' CONNAME ( 1 :: 2);
  • For C/C++, enter the following command to display the contents of container conName, which is in the current channel: 
    LIST CONTAINER conName;

Refer to the following topics for more information related to the material discussed in this topic.