SVM display

The z/TPF system provides several commands to display the contents of system virtual memory (SVM). You can choose to display SVM directly on the console or write the formatted display to a file in the z/TPF file system.

The following commands are used to display SVM areas of various types:
  • ZDCOR
  • ZDCNF
  • ZDDCA
  • ZDSHP
  • ZDGBL

Display SVM on the console

If you want to display SVM directly on the console, take one of the following actions:
  • When you enter the ZDCOR, ZDCNF, ZDDCA, or ZDSHP command, do not specify the FILE parameter.
  • When you enter the ZDGBL command, do not specify the OUTPUT parameter.

Write an SVM display to a file

To write a display of the requested SVM area to a file, take one of the following actions:
  • When you enter the ZDCOR, ZDCNF, ZDDCA, or ZDSHP command, specify the FILE parameter.
  • When you enter the ZDGBL command, specify the OUTPUT parameter.

Format a SVM display

When you specify the FILE or OUTPUT parameter to write an SVM display to a file, you can choose one of the following file types:
  • .txt
  • .csv
  • .json
  • .xml
  • .properties
The specified file type determines how the data is formatted when it is written to the file:
  • If the .txt file type is specified, the data that is written to the file is formatted in the same way as it is displayed on the console. The output file is in EBCDIC encoding.
  • If the .csv, .json, .xml, or .properties file type is specified, the data that is written to the file is formatted based on the structure of the memory area. The output file is in UNICODE.

    The data is formatted by using a DFDL schema file that describes the structure of the memory area. The formatted data contains the name and value of each field in the memory structure. The memory schema configuration file is used to associate DFDL schema files with specific memory areas.

The ZDCOR command accepts only the .txt file type.

The ZDGBL command accepts any file type. If a file other than .txt, .csv, .json, .xml, or .properties is specified, the hexadecimal contents of the requested format-2 global record are written to the file.

To write a formatted SVM display to a file, complete the following steps:
  1. Add an entry to the memory schema configuration file.
  2. Based on the requested memory area type, enter one of the display commands with the FILE or OUTPUT parameter specified.

Look up the value of a memory structure field

When you enter the ZDCNF, ZDDCA, ZDSHP, or ZDGBL command, you can specify the FIELD parameter to look up the value of a specific field in the memory structure. With this parameter specified, only the requested field and its value are displayed on the console.

When the FIELD parameter is specified, you cannot specify the FILE or OUTPUT parameter.