Previous Topic: IDMSINTL User ExitNext Topic: OPER Enhancements


Type Qualifier on Vary Program

The DCMT VARY PROGRAM command was enhanced to let you specify the type of program being varied.

While more than one program can exist with the same name and version, each program has a different type. By specifying the program type on the DCMT VARY PROGRAM command, you can fully identify the program to be varied. This enhancement eliminates the need to issue a prompt for type information, which makes it easier for you to broadcast DCMT VARY PROGRAM commands and include them in UCF batch scripts.

DCMT VARY PROGRAM Statement

The DCMT VARY PROGRAM command now allows qualification by program type.

DCMT VARY PROGRAM Syntax

The following diagram shows the type qualifier enhancement to the DCMT VARY PROGRAM command:

►►─ DCMT ──┬─────────────────────┬─────────────────────────────────────────►
           └─ broadcast-parms ───┘
 ►─ Vary PRogram program-specification ─── . .  ─────────────────────────►◄

Expansion of program-specification

►►─┬──────────────────────┬── program-name ───────────────────────────────► 
   └─ dictnode.dictname. ─┘
 ►─────┬──────────────────────────┬───────────────────────────────────────► 
       └─ Version version-number ─┘
 ►─────┬─────────────────────────────┬────────────────────────────────────►◄ 
       └─ TYPE ─┬─ ACCess MODule ──┬─┘ 
                ├─ AM ─────────────┤
                ├─ DIAlog ─────────┤
                ├─ MAP ────────────┤
                ├─ PROgram ────────┤
                ├─ RCM ────────────┤
                └─ TABle ──────────┘

DCMT VARY PROGRAM Parameters

This section describes the new parameters that support the type qualifier enhancement to the DCMT VARY MEMORY command.

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:

Note: When the TYPE keyword appears as part of the program specification it is used to identify a particular program. The TYPE keyword following the DEFINE keyword is used to redefine the type of the program.