Application and Dialog Utilities › ADSOBTAT › Control Statements

Control Statements

Purpose

Syntax

►►───┬─────────────────────────────────────────┬──────────────────────────────►
     └─ DICTNAME ──┬──────┬── dictionary-name ─┘
                   ├─ IS ─┤
                   └─ =  ─┘

 ►───┬────────────────────────────────────┬───────────────────────────────────►
     └─ DICTNODE ──┬──────┬── node-name ──┘
                   ├─ IS ─┤
                   └─ =  ─┘

 ►───┬───────────────────────────────────────────────────────────────┬────────►
     └─ LOCation for ─┬─ APPlication ─┬───┬──────┬───┬─ loadAREA ◄ ─┬┘
                      └─ ADB ─────────┘   ├─ IS ─┤   └─ loadLIB    ─┘
                                          └─ =  ─┘

     ┌───────────────────────────────────────────────────────────────┐
 ►───▼──┬──────────┬──┬── APPlication ─┬───┬──────┬─── application ──┴────────►◄
        ├─ ADD ────┤  └── ADB ─────────┘   ├─ IS ─┤
        ├─ MODify ─┤                       └─ =  ─┘
        └─ DELete ─┘

Expansion of Application

►─── application-name ─┬─────────────────────────────────────────┬───────────►◄
                       └─ VERsion ───┬──────┬─── version-number ─┘
                                     ├─ IS ─┤
                                     └─ =  ─┘

Parameters

DICTNAME IS dictionary-name

Specifies the 1- to 8-character name of the data dictionary in which the TAT is stored.

DICTNAME defaults to the name of the primary dictionary.

DICTNODE IS node-name

Specifies the node that controls the data dictionary in which the TAT is stored.

LOCation for APPlication IS

Introduces where the applications specified in the control statements are stored.

ADB can be used in place of APPLICATION; the equals sign (=) can be used in place of IS.

loadAREA

Specifies that the applications are stored in the load area.

LOADAREA is the default when no location for application is specified.

loadLIB

Specifies that the applications are stored in the load (core-image) library.

The load libraries in which the applications are stored must be specified in the JCL, as follows:

• z/OS JCL -- In the CDMSLIB statement or, if a CDMSLIB statement is not specified, in the STEPLIB statement
• z/VSE JCL -- In the ASSGN/EXTNT statement for the private core-image library or in the LIBDEF equivalent
• z/VM commands -- In the GLOBAL LOADLIB command, added to the list of libraries

ADD

Specifies that task code entries for an application are being added to the TAT.

If ADD is specified and the TAT already contains entries for the application, the action is changed to MOD and a warning message is displayed. If ADD is specified and the TAT does not exist, ADSOBTAT creates a TAT.

ADD is the default if the TAT contains no entries for the application.

MODify

Specifies that the task code entries for an application are being replaced in the TAT by the task codes defined in the current application load module.

If MOD is specified and the TAT does not contain entries for the application, ADSOBTAT treats the request like an ADD request.

MOD is the default if the TAT already contains entries for the application.

DELete

Specifies that the task code entries for an application are being deleted from the TAT.

If the TAT does not contain entries for the application, a warning message is issued. Note that the application does not have to exist when DEL is specified.

APPlication IS application

Identifies the application.

See expansion of application below.

application-name

Specifies the name of the application.

VERsion is version-number

Gives the version number (in the range 1 through 9999) of the application.

The default version number is 1.

Usage

Considerations

If specified, the DICTNODE and DICTNAME clauses must be coded first, in any order. The LOCATION clauses, if specified, must be coded next, in any order. The ADD/MODIFY/DELETE APPLICATION clause must be coded last, and can be repeated any number of times to reference several applications.