Previous Topic: z/VM commandsNext Topic: Control Statements


ADSOBTAT

What It Is

ADSOBTAT is a batch utility that allows the application developer to add, modify, and delete entries in the task application table (TAT). For example, ADSOBTAT can be used to update the TAT for a dictionary when an application is migrated to that dictionary.

Note: When an application is added, modified, or deleted by using the application compiler, the TAT is automatically updated in the applicable dictionary, and ADSOBTAT is not required. The TAT can also be updated online by using ADSOTATU, as described under 'ADSOTATU' earlier in this appendix.

How It Works

At the beginning of an ADSOBTAT run, ADSOBTAT copies the TAT stored either in the load area or, if the load area has no TAT, in the load library. If no TAT exists, ADSOBTAT creates a new TAT if the action is ADD. ADSOBTAT updates the copy of the TAT, based on the control statements provided. At the end of the run, if the control statements contain no errors, ADSOBTAT stores the copy of the TAT in the load area, replacing any previous copy.

ADSOBTAT does not update a TAT's program description element (PDE) to indicate that a new copy of the TAT exists in the load area. If a TAT is updated by ADSOBTAT and then referenced during a single DC/UCF run, the application developer should update the PDE by issuing the following command:

DCMT VARY PROGRAM $ACF@TAT NEW COPY

Note: For more information on the DCMT VARY PROGRAM command, see the CA IDMS System Tasks and Operator Commands Guide.

ADSOBTAT Output

ADSOBTAT produces a listing that displays the card images of all control statements processed. Error messages, if any, are listed under their associated control statements. If an error in any control statement prevents ADSOBTAT from updating the TAT, ADSOBTAT issues the following message:

DC474029   *** WARNING *** DUE TO ABOVE ERROR TAT WILL NOT BE
UPDATED DURING THIS RUN; SYNTAX CHECKING ONLY

Note: At a site where alternate dictionaries are used, the system database name table must map network subschema IDMSNWKL (used by ADSOBTAT) to the copy of the network subschema appropriate for the alternate dictionary. The database name table is defined by the DBNAME statement.

More information:

CA ADS Application Compiler (ADSA)