RENUM subcommand — renumber symbol table entries

Use the RENUM subcommand to renumber all address pointer entries in the symbol table in your dump directory. IPCS renumbers the entries in ascending order, from Z1 to Z99999.

The symbol table is part of a source description. The source description is in the dump directory allocated with ddname IPCSDDIR and is your current dump directory. The current dump directory is your user dump directory or, for users with write access authority, might be the sysplex dump directory.

Related subcommands
- EQUATE
- DROPSYM
- LISTSYM
- STACK

Syntax

    {RENUM }    [ SUMMARY | NOSUMMARY ]
    {REN   }

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

              [ ACTIVE| MAIN | STORAGE          ]
              [ DSNAME(dsname)| DATASET(dsname) ]
              [ FILE(ddname)| DDNAME(ddname)    ]
              [ PATH(path-name)     ]
              [ TEST | NOTEST ]

Parameters
SUMMARY or NOSUMMARY
SUMMARY specifies that a summary of RENUM's processing is to be produced. If so, IPCS issues one of the following comments (where n is a number):
- The stack contains no entries.
- The stack contains 1 entry, none was renumbered.
- The stack contains 1 entry, 1 was renumbered.
- The stack contains n entries, 1 was renumbered.
- The stack contains n entries, n of which was renumbered.
- The stack contains n entries, none of which was renumbered.
NOSUMMARY specifies that a processing summary is to be suppressed. The NOSUMMARY parameter is useful to turn off summary messages when the subcommand is invoked within a CLIST or REXX exec.
ACTIVE or MAIN or STORAGE

DATASET(dsname) or DSNAME(dsname)

FILE(ddname) or DDNAME(ddname)

Specifies the source of the source description containing the symbols. If one of these parameters is not specified, the source is your current source.
ACTIVE, MAIN, or STORAGE specifies central storage as the source.

DSNAME or DATASET specifies the name of a cataloged data set as the source.

FILE or DDNAME specifies the ddname for a data set as the source.
Return codes
See Standard subcommand return codes for a description of the return codes produced by the RENUM subcommand.
Example: Renumber the address pointer entries in the symbol table.
- Action
```
COMMAND ===> renum
```
- Result
  The subcommand produces the following summary output line:
```
The stack contains 4 entries, 3 of which were renumbered
```