Previous Topic: DCMT VARY PROGRAM SyntaxNext Topic: DCMT VARY PROGRAM Usage


DCMT VARY PROGRAM Parameters

broadcast-parms

Indicates to execute the DCMT command on all or a list of data sharing group members.

Note: For more information about broadcasting and broadcast-parms syntax, see the section How to Broadcast System Tasks.

ADSo STATistics

Specifies the setting for the ADSO statistics. Valid values are:

ON

Selects statistics collection for the dialog identified by program-name.

You select dialogs for statistics collection at system generation time by using the ADSO DIALOG STATISTICS parameter of the PROGRAM statement.

OFF

Turns off statistics collection for the dialog identified by program-name.

DEFine
CONcurrent

Specifies that the program can be used by multiple tasks at the same time. If the program is reentrant or quasi-reentrant, one copy of the program is used to process all requests. If the program is nonreentrant, as many copies of the program are used as necessary to process requests concurrently.

NONCONcurrent

Specifies that the program can be used by only one task.

ISA size

For Assembler and PL/I programs only, specifies the amount of storage, in bytes, allocated for the program's initial storage area (ISA). If an ISA is specified, GET STORAGE statements are not required in the program because the system automatically allocates the requested storage when the program begins executing. The storage address is passed in register 11.

isa-size The amount of storage allocated for an assemble or PL/I program. isa-size is an integer in the range 0 through 2,147,483,647.

LANguage

Identifies the language in which the program is written. Valid languages are:

ADSo CA ADS

ASSembler Assembler program

COBol COBOL program

PLI PL/I program

MAInline

For CA IDMS dialogs only, indicates the dialog is a mainline dialog. Dialogs defined as MAINLINE are entry points into applications. The names of mainline dialogs are eligible for display on the CA IDMS menu screen if so allowed by ADSO statement specifications.

If you specify MAINLINE, the dialog must be generated with the MAINLINE attribute but does not have to be assigned a task code during system generation.

NOMAINline

For CA IDMS dialogs only, indicates the dialog is not a mainline dialog.

MPMode

Specifies the multiprocessing mode (MPMODE) for the program.

ANY Assigns an MPMODE of ANY to the program. ANY is appropriate for reentrant and quasi-reentrant programs that are defined without storage protection.

SYStem Directs the system to assign an MPMODE to the program at execution time.

New Copy

Specifies whether the new copy facility is enabled for the program or subschema.

ENabled Specifies the new copy facility for the program or subschema is enabled.

DIsabled Specifies the new copy facility for the program or subschema is disabled.

OVErlayable

Specifies that the program can be overlaid in the program pool. You should specify OVERLAYABLE only for executable programs invoked through normal DC mechanisms.

NONOVErlayable

Specifies that the program cannot be overlaid in the program pool. You should specify NONOVERLAYABLE for nonexecutable programs (for example, tables) to prevent such programs from being overwritten in the program pool while they are in use.

REEntrant

Specifies that the program is reentrant. To be declared reentrant, the program must acquire all variable storage dynamically and must not modify its own code.

NONREEntrant

Specifies that the program is nonreentrant. Programs that modify their own code and do not ensure the modified code is returned to its original state when the program is not in control must be declared NONREENTRANT.

QUAsireentrant

For COBOL programs only, specifies the program is quasi-reentrant. To be declared quasi-reentrant, a program must not modify its own code unless the program ensures the modified code is returned to its original state when the program is not in control. Quasi-reentrant programs are permitted to use working storage because each time the program is executed the system creates a separate copy of its working storage in the storage pool. This technique makes the program, in effect, reentrant.

REUsable

Specifies that the program can be executed repeatedly. When a request to load the program is issued, the system loads a copy of the program from external storage only if no copy exists in the program pool.

To be declared REUSABLE, a program must return all modified code to its original state for each execution. Generally, code is returned to its original state either at the start of a new execution of the program or at the finish of the previous execution. By definition, reentrant and quasireentrant programs are always reusable; however, reusable programs are not necessarily reentrant or quasireentrant.

NONREUsable

Specifies that the program cannot be executed repeatedly. When a request to load the program is issued, the system loads a copy of the program from external storage. Programs that modify their own code without returning the code to its original state must be declared NONREUSABLE.

SAVearea

For Assembler programs only, specifies that the system will acquire a save area automatically before each execution of the program. The save area address is passed to the program in register 13. You should specify SAVEAREA or accept it by default if the program uses normal IBM calling conventions and, at the start of execution, saves registers in the save area.

NOSAVEarea

For Assembler programs only, specifies the system will not acquire a save area for the program automatically.

TYPe

Specifies one of the following program types:

  • DIAlog
  • MAP
  • PROgram
  • SUBschema
  • TABLe
Dump Threshold

Varies the dump threshold for the program.

The dump threshold is the number of times a memory dump is taken for program check errors that occur in the program. The dump threshold is established at system generation time by the DUMP THRESHOLD parameter of the PROGRAM statement.

error-count

The new dump threshold for the program: an integer in the range 0 through 255.

ENable

Enables the program. A program is enabled at system generation time by the ENABLE parameter of the PROGRAM statement.

DIsable

Disables the program. Disabling a program prevents it from being executed until it is enabled. A program is disabled at system generation time by the DISABLE parameter of the PROGRAM statement.

MULtiple ENClave is

Specifies if this program can use the same language enclave as other LE programs in the same task. This parameter is only meaningful for COBOL programs.

OFF

Specifies that this program cannot participate in a multiple program LE enclave.

ON

Specifies that this program can participate in a multiple program LE enclave. This is the default.

Note: This value is only effective if MULTIPLE ENCLAVE IS ON isspecified on the SYSTEM statement in the sysgen.

New Copy

Updates the program definition element (PDE) for the program to indicate that a new copy of the program exists in the load area of the dictionary (or in the load library).

Note: Requests of IMMEDIATE for subschemas is ignored. Subschemas areprocessed as though Quiesce is requested.

Immediate

Aborts (with an abend code of MTPR) all tasks using the named program. At the next request to load the program, DC/UCF loads the new copy.

Quiesce

Places tasks that request a load of the named program in a wait state until all tasks currently using the program relinquish it. When the program is no longer in use, DC/UCF loads the new copy and releases the waiting tasks.

Program Check Threshold

Varies the program check threshold for the program.

The program check threshold is the number of program check errors that can occur before DC/UCF disables the program. The program check threshold is established at system generation time by the ERROR THRESHOLD parameter of the PROGRAM statement.

error-count

The new program check threshold; an integer in the range 1 through 255.

Storage Protect ON

Enables storage protection for the named program. Storage protection is enabled at system generation time by the PROTECT parameter of the PROGRAM statement.

Storage Protect OFF

Disables storage protection for the named program. Storage protection is disabled at system generation time by the NOPROTECT parameter of the PROGRAM statement.

Program-specification parameters

broadcast-parms

Executes the DCMT command on all or a list of data sharing group members.

For more information on broadcasting and broadcast-parms syntax, refer to the section "How to Broadcast System Tasks" in the CA IDMS System Tasks and Operator Commands Guide.

program-specification

Specifies the program to vary.

dictnode

Specifies the DDS node that controls the data dictionary where the named program resides.

If a node name is not specified, the default DDS node established for the session is accessed. If a default DDS node has not been established, the local node is accessed.

dictname

Specifies the alternate data dictionary in which the named program resides.

Note: Although dictnode and dictname are both optional parameters, if dictnode is specified and dictname is not specified, a "." delimiter must be included to represent the missing dictname parameter as shown in the following example:

DCMT V PROGRAM dictnode..program-name V version-number 
program-name

The name of a program that has been defined on a system generation PROGRAM statement or previously loaded by the DC/UCF system.

version-number

The version number of the program.

Default: 1

TYPe

The type of the program:

Snap-options parameters

SNAp snap-options

Specifies the type of snap dump or photo snap to write to the DC/UCF log file.

Valid values are the following:

SYSTEM

Specifies whether to write a system snap dump for the specified program. A system snap dump writes a formatted display of the resources allocated to all active tasks.

ON Enables the writing of a system snap dump.

OFF Disables the writing of a system snap dump.

SYSTEM PHOTO

Specifies whether to write a system photo snap for the specified program. A system photo snap provides a summary of resources for all active tasks.

ON Enables the writing of a system photo snap.

OFF Disables the writing of a system photo snap.

TASK

Specifies whether to write a task snap dump for the specified program. A task snap dump writes a formatted display of the resources allocated to the task being snapped.

ON Enables the writing of a task snap dump.

OFF Disables the writing of a task snap dump.

TASK PHOTO

Specifies whether to write a task photo snap for the specified program. A task photo snap provides a summary of the resources for the task being snapped.

ON Enables the writing of a task photo snap.

OFF Disables the writing of a task photo snap.

LIMIT nnn

Specifies the total snaps allowed for the specified program. When the snap limit is reached, snaps are disabled for the program. The maximum snap limit value is 999.