DATATAKEUP

Purpose

Defines or updates CICS® configurations that refer to CSD files or contexts. Use this batch command as a timesaving alternative to the interactive ISPF dialog option 1.2 CICS Configurations. Rather than using the dialog to work with CICS configurations one at a time, you can use this command to define or update all of your CICS configurations in a single batch job.

To define or update CICS configurations that refer to export files, use the ISPF dialog interface.

Before defining or updating CICS configurations that refer to CSD files, read Defining CICS configurations that refer to CSD files.

Format

Read syntax diagramSkip visual syntax diagram
                             .-,DDNAME=CCONFIG------.   
>>-DATATAKEUP--TYPE=CCONFIG--+----------------------+----------->
                             '-,DDNAME=input_ddname-'   

   .-,REPLACE=NO--.   
>--+--------------+--------------------------------------------><
   '-,REPLACE=YES-'   

TYPE
The type of data to take up: must be CCONFIG (CICS configurations), the only type of data take-up currently supported.
DDNAME
The ddname of the input data set for the DATATAKEUP command.

The input data set contains text arranged in columns, specifying the attributes of the CICS configurations that you want to define or update.

The records in this input data set must be sorted in a particular order. Unless your input data set is already sorted in the required order, you need to sort it before calling DATATAKEUP. Rather than referring to the data set name of the original, unsorted input data set, the DDNAME parameter could refer to the output of a sort step. For details, see JCL to define CICS configurations.

REPLACE
Specifies what to do if the DATATAKEUP input data set specifies the name of a CICS configuration that already exists in the CICS Configuration Manager repository.
YES
Update the CICS configuration:
  • Overwrite individual attributes, such as the description and the RLS access option (CSDRLS).
  • Add repeating elements, such as transformation variables and remote system connections. (You cannot use DATATAKEUP to remove existing repeating elements. To remove repeating elements from a CICS configuration, use the ISPF dialog interface.)
NO
Leave the CICS configuration untouched; ignore the records for this CICS configuration in the input data set.

Reference Reference

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//ccv-batch-cmd-datatakeup.htm