STRUCTUREMAP Request

The STRUCTUREMAP request produces a map showing file storage layout by family index and address. The report contains the file name, the areas, the area class, the family index, the segment address, the size in segments, and the number of segments on the family. Output is sent to the printer by default.

Note: The report contains a FILE NUMBER for each file listed. However, the FILE NUMBER shown in the report is the number of the file in the FILEDATA database, not the number of the file in the report. The FILE NUMBER column accommodates numbers up to and including 9,999,999. Any number larger than 9,999,999 is truncated to the left.

<structuremap request> 

── STRUCTUREMAP ───────────────────────────────────────────────────────►
►─ : ─┬───────────────────────────────────────────────┬────────────────┤
      │ ┌◄──────────────────────────────────────────┐ │
      └─┴─┬─ ARCHIVE ─────────────────────────────┬─┴─┘
          ├─ CATALOGUE ───────────────────────────┤
          ├─ DATABASE ────┬─ = ──<file title>─────┤
          ├─ DIRECTORY ───┤                       │
          ├─ NEWDATABASE ─┤                       │
          ├─ TITLE ───────┘                       │
          ├─ DELETED ── = ──<family index number>─┤
          ├─ LEVEL ── = ──<integer>───────────────┤
          ├─<output option>───────────────────────┤
          ├─ FAMILYNAME ─┬─ = ──<family name>─────┤
          ├─ PACKNAME ───┘                        │
          ├─ RAWHEADERS ──────────────────────────┤
          └─ REMOVED ─────────────────────────────┘

Explanation

For more information about <output option> refer to “Output Options” earlier in this section.

The following FILEDATA modifiers perform functions such as selecting the disk family or file names to be reported on, and specifying the types of information to be reported for each file. These modifiers are explained under “FILEDATA Modifiers” later in this section.

  • ARCHIVE

  • CATALOGUE

  • DATABASE

  • DELETED

  • DIRECTORY

  • FAMILYNAME

  • LEVEL

  • NEWDATABASE

  • PACKNAME

  • RAWHEADERS

  • REMOVED

  • TITLE

STRUCTUREMAP Example

The following command generates a STRUCTUREMAP request on all files and directories on MYPACK with one or two level file names. The output is sent to a remote terminal. 

RUN *SYSTEM/FILEDATA("STRUCTUREMAP:
LEVEL = 2 SCREEN FAMILYNAME = MYPACK")
Prev  Up  Next
NOREPORTS Request  Home  TAPEDIR Request