DCMT DISPLAY PROGRAM Command

DCMT DISPLAY PROGRAM displays information associated with DC/UCF programs. It displays the contents of the Program Definition Element (PDE) for each program.
idmscu19
DCMT DISPLAY PROGRAM displays information associated with DC/UCF programs. It displays the contents of the Program Definition Element (PDE) for each program.
This article describes the following information:
Syntax
►►─── DCMT ─┬───────────────────┬─────────────────────────────────────────────►             └─ 
broadcast-parms
 ─┘  ►─── Display ────────────────────────────────────────────────────────────────►  ►─┬─ PRogram 
program-specification
 ────────────────────┬─────────────────────►◄    └─ PRograms ─┬─────────────────────────────────────┬─┘                 └─ from 
program-name
 to 
program-name
 ─┘
Expansion of program-specification
 ►──┬──────────────────────┬─ 
program-name
 ─┬──────────────────────────┬──────►◄     └─ 
dictnode
.
dictname
. ─┘                └─ Version 
version-number
 ─┘
Parameters
  • broadcast-parms
    Indicates to execute the DCMT command on all or a list of data sharing group members.
    For more information about broadcasting and
    broadcast-parms
    syntax, see the section How to Broadcast System Tasks.
  • Program
    Displays information about a specified program.
  • program-specification
    Specifies the program to display:
  • dictnode
    Specifies the DDS node that controls the data dictionary in which the named program resides.
  • dictname
    Specifies the alternate data dictionary in which the named program resides. The default is the DICTNAME setting for the current session. To specify that the system default dictionary is to be searched for the named program, use the value * for
    dictname
    .
    Although
    dictnode
    and
    dictname
    are optional parameters, if
    dictnode
    is specified and
    dictname
    is not specified, a "." delimiter must be included to represent the missing
    dictname
    parameter. For example:
    DCMT V PR dictnode..program-name V version-number
    • program-name
      The name of the program, as defined on the system generation PROGRAM statement or on a DCMT VARY DYNAMIC PROGRAM command.
    • Version
      version-number
      The version number of the specified DC/UCF program.
      The default is 1.
    The loadlist enabled for your current terminal session determines how DC/UCF searches for a program based on a DCMT DISPLAY PROGRAM command. However, this loadlist search can be bypassed and superseded by fully qualifying the program name. If VERSION, DICTNODE, or DICTNAME is specified in the DCMT command, then this is considered a fully qualified name and the loadlists are not used.
  • PRograms
    Displays information for each of the following types of programs:
    • Programs defined at system generation time
      by means of the PROGRAM statement
    • Dynamically defined programs
      defined by means of the DCMT VARY DYNAMIC PROGRAM command discussed in 5.18, "DCMT VARY DYNAMIC PROGRAM".
    • Automatically generated programs
      defined by means of DC/UCF compilers and definition tools, edit table, and code table definitions
  • from
    program-name
    to
    program-name
    Specifies the range of programs to be displayed.
    Program-name
    specifies the start or all of a program name. For example, FROM IDMS TO RHDC displays all programs that begin with IDMS through those that begin with RHDC.
Usage
How DC/UCF Searches for a Program
The load list enabled for your current terminal session determines how DC/UCF searches for a program based on a DCMT DISPLAY PROGRAM command.
Display for a Specified Program
DCMT DISPLAY PROGRAM displays the following information for the specified DC/UCF program:
Field
Value
Column One
 
Program name
Program name
Type
Indicates program type: AM, DIALOG, DIALOG MAINLINE, DRIVER, MAP, NUCLEUS, PROGRAM, RCM, SUBSCHEMA, TABLE, or UNDEFINED
Language
Language in which the program is written
Size (in bytes)
The size of the program, in bytes
ISA Size
Initial storage area size, in bytes
Status
Indicates the status of the program: ENABLED AND INSRV or DISABLED AND OUTSRV
Dynamic
Indicates whether additional versions of this program can be defined at runtime: ALLOWED or NOT ALLOWED
Reusable
Indicates whether the program is available for use in the program pool: YES or NO
Reentrant
Indicates the reentrant status of the program: FULLY REENTRANT, QUASI-REENTRANT, or NON-REENTRANT
Tasks use ct
The number of tasks currently using the program
Times called
Number of times called
PGM chk thrh
The number of program checks that can occur before the program is disabled
Dump thrh
The number of dumps that can occur before the program is disabled
Amode
Indicates whether the program can address XA storage
PDE address
Address of PDE
Savearea
Indicates whether a savearea will be allocated when the program is invoked: YES or NO
Column Two
Ddname/Version
ddname (Type=Loadlib) or version number (Type=Dictionary)
Dictname
Name of the data dictionary in which the program resides (if blank, installation default dictionary)
Dictnode
Name of the DDS node that controls the data dictionary in which the program resides (if blank, local DDS node)
Database key
The database key of the program (for modules stored in the data dictionary)
Storage Prot
Indicates whether storage protection is enabled for the program: YES or NO
Residence
Indicates the residence status of the program: PERMANENT, IN POOL, or NOT IN POOL
Note:
If the program is permanent or in the pool, the address of the program is given, or an indication that multiple copies are present is given.
Threading
Indicates the type of threading for a program as follows:
CONCURRENT -- The program is multithreaded
NON-CONCURRENT -- The program is single threaded
Overlayable
Indicates whether the program is over layable: YES or NO
New Copy
Indicates the new copy status of the program: ENABLED or DISABLED
Times loaded
Number of times loaded
Pgm check ct
Number of program checks that occurred for the program since it was defined or enabled
Dump ct
Number of dumps performed for the program since it was defined or enabled
Rmode
Indicates where the program can run: 24 or ANY
MPmode
Indicates the MPmode of the program: SYSTEM or ANY
Mult Enclave
Indicates whether a COBOL program is eligible to run in a multiple program enclave: YES or NO
If multiple copies of the program are present, the following information is displayed for each copy:
Field
Value
Address
The address of the copy
Debug
Indicates the debug status of the copy: YES or NO
In Pool
Indicates the residence status of the copy as follows:
YES -- The copy is currently in memory
NO -- The copy has been paged out
Copy
Indicates the type of copy as follows:
TEMP -- The copy is non-resident
PERM -- The copy is resident
Display for Every Program
DCMT DISPLAY PROGRAMS displays the following information for every program:
Field
Value
Program
Program name
Typ
Program type
D
Dictionary origin. If the program was loaded from a data dictionary, a D is displayed. Otherwise, the program was loaded from a load library.
DDname/Version#
Version number (Type=Dictionary) or ddname (Type=Loadlib).
Dictname
Name of the data dictionary in which the program resides.
Node
Name of the DDS node that controls the data dictionary in which the program resides.
Examples
DCMT DISPLAY PROGRAMS
    D PRO IDMSCOMP    Program Name IDMSCOMP            Ddname          CDMSLIB    Type         PROGRAM             Type            LOADLIB    Language     ASM                 Dictname    Size (bytes) 00001600            Dictnode    ISA size     00000000            Database key    NOT IN DICT    Status       ENABLED AND INSRV   Storage Prot    NO    Dynamic      NOT ALLOWED         Residence       PERMANENT AT 39642A00    Reusable     YES                 Threading       CONCURRENT    Reentrant    FULLY REENTRANT     Overlayable     YES    Tasks use ct 003                 New Copy        ENABLED    Times called 00000015            Times loaded    000001    PGM chk thrh 005                 Pgm check ct    000    Dump thrh    000                 Dump ct         000    Amode        31                  Rmode           ANY    PDE address  36D11878            MPmode          SYSTEM    Savearea     YES                 Mult Enclave
DCMT DISPLAY Specified Program
       DISPLAY PROGRAM IDMSCOMP    Program Name IDMSCOMP               Ddname          CDMSLIB    Type         PROGRAM                Type            LOADLIB    Language     ASM                    Dictname    Size (bytes) 00001592               Dictnode    ISA size     00000000               Database key    NOT IN DICT    Status       ENABLED AND INSRV      Storage Prot    NO    Dynamic      NOT ALLOWED            Residence       PERMANENT AT 38904000    Reusable     YES                    Threading       CONCURRENT    Reentrant    FULLY REENTRANT        Overlayable     YES    Tasks use ct 002                    New Copy        ENABLED    Times called 00000015               Times loaded    000001    PGM chk thrh 005                    Pgm check ct    000    Dump thrh    000                    Dump ct         000    Amode        31                     Rmode           ANY    PDE address  36C5D214               MPmode          SYSTEM    Savearea     YES                    Mult Enclave
DCMT DISPLAY Range of Programs
      DISPLAY PROGRAMS FROM DBUGMNRE TO IDBCAT     *** Program Definition Table - Dictionary Modules Indicated by "D" *** Program   Typ  D  DDname/Version#     DictName   Node DBUGMNRE  ASM     CDMSLIB DBUGMNSE  ASM     CDMSLIB DBUGMNSN  ASM     CDMSLIB DBUGMNVR  ASM     CDMSLIB DBUGSTAE  ASM     CDMSLIB DCPROFIL  ASM     CDMSLIB DDAMDBUG  ASM     CDMSLIB DNSCTAB   ASM     CDMSLIB DNSSCSES  ASM     CDMSLIB DNSSCTL   ASM     CDMSLIB DNSSDICT  ASM     CDMSLIB EDBBNOTE  ASM     CDMSLIB EMPSS01   SUB  D  VERSION 1 ESVSAMBE  NUC     CDMSLIB ESVSPVLR  ASM     CDMSLIB IBMDEOCA  ASM     CDMSLIB IBMDESMA  ASM     CDMSLIB IDB       ADS     CDMSLIB IDBCAT    ASM     CDMSLIB IDBCATI   ASM     CDMSLIB
More Information
  • For more information about load lists, see documentation of the LOADLIST statement in the
    Administrating section
    and the discussion of load lists in the
    System Reference section
    .
  • For more information about displaying the dictionary definition for the program, see documentation of the PROGRAM statement in the
    IDD DDDL Reference section
    .
  • For more information about varying program attributes, see DCMT VARY PROGRAM.
  • For more information about PDEs, see the
    Administrating section
    .