PROGMAP

Options

Notes:

¹ Options entered between the left '(' and right ')' delimiters can be in any order.

Authorization

General User

Purpose

Use the PROGMAP command to display or place on the program stack information about programs currently loaded in storage.

Operands

progname

returns information about all programs with the specified program name.

For a program loaded by the LOAD, INCLUDE, or LOADMOD commands, OS Simulation (LOAD, LINK, or ATTACH), or MODULEs invoked as commands (that have NOCLEAN attribute), progname is the file name.
For a nucleus extension, progname is the command name.

An asterisk (*) will return information on all user programs, or nucleus extensions, or both. The default is an asterisk.

Options

PROGRAM: returns information for program(s) loaded by the LOAD, INCLUDE, or LOADMOD commands, OS Simulation (LOAD, LINK, or ATTACH), or MODULEs invoked as commands (that have NOCLEAN attribute). This is the default.
NUCX: returns information for nucleus extensions.
ALL: returns information for both programs and nucleus extensions.
NOSEGment: returns information on nucleus extensions that do not reside in loaded logical segments.
SEGment segname: returns information on nucleus extensions that reside in loaded logical segments. The segname specifies the 1-8 character name of a logical segment. An asterisk (*) indicates all logical segments are to be searched for the nucleus extensions specified by progname.
STACK FIFO
STACK LIFO: specifies CMS return information to the program stack rather than display the information at the terminal. The FIFO and LIFO options determine how the information is stacked. The default order is FIFO.
FIFO: stacks PROGMAP information first in first out on the program stack. The options STACK, STACK FIFO, and FIFO are equivalent.
LIFO: stacks PROGMAP information last in first out on the program stack. The options STACK LIFO and LIFO are equivalent.

Usage Notes

To display PROGMAP information at your terminal, omit the STACK, FIFO, and LIFO options. Use the STACK option to place the information on the program stack.
The ALL option displays information on programs and nucleus extensions. For more information on NUCEXT look-aside entries, see NUCXMAP.
PROGMAP does not display the attributes of transient area modules.

Examples

If you enter PROGMAP PROG1, only information for PROG1 will be returned:

Name        Entry       Origin      Bytes        Attributes
PROG1       02000400    04000400    0000066D    Amode 31  Reloc

If the command PROGMAP (ALL is entered, all programs and nucleus extensions are listed:

Name        Entry       Origin      Bytes        Attributes
PROG1       02000400    04000400    0000066D    Amode 31 Reloc
PROG2       02000A6D    04000A6D    0000042A    Amode 31 Reloc
PROG3       00020000    00020000    0000C778    Amode 24 Non-reloc
 
Name  Entry    Userword Origin   Bytes   Amode (Attributes)
NUCX1 0035A000 00000000 00000000 00000000   31  SYSTEM SERVICE
NUCX2 0035E934 00361828 00000000 00000000  Any  SYSTEM
NUCX3 004DB000 00000000 004DB000 00001FF8   24  SYSTEM SERVICE IMMCMD PERM

Note: All text decks are considered to be nonrelocatable programs whether you specified ‘RLDSAVE’ on the LOAD command. Therefore the ‘NON-RELOC’ attribute will be in the response from PROGMAP. However, when a module file is generated by GENMOD from a loaded text deck(s), the RLDSAVE/NORLDSAV option indicated during the LOAD process determines whether the module file will be relocated when it is loaded by LOADMOD.

Messages and Return Codes

DMS415E Invalid character char in program name name [RC = 20]
DMS941I User program progid is not loaded [RC = 0]
DMS942I No user programs are loaded [RC = 0]

An additional system message may be issued by this command. The reason for this message and its location are:

Reason	Location
Errors in command syntax	Command Syntax Error Messages