IDCAMS

The IDCAMS keyword is valid with the BUILD, CLONE, RELOAD, REORG, GROUP, and COPY commands.

You can specify this option in the environment setup member (DLIGSET0) or in PLUSIN. The following table describes the IDCAMS keyword.

To do this

Specify this in PLUSIN

Specify input file for IDCAMS VSAM processing.

IDCAMS(input)

Specify input and output files for IDCAMS processing.

IDCAMS(input,output)

Use the data set referenced by the AMSPDS DD statement as input for IDCAMS processing.

IDCAMS(*)

IDCAMS(*,output)

Reclaim DASD space after a Online Reorg function reorganization completes.

IDCAMS(input,output,Y)

Do not reclaim DASD space.

IDCAMS(input,output,N)

Specify an existing cluster from which the attributes used to define the new cluster should be copied.

IDCAMS(model)

IDCAMS(model,output)

Internal default: No ddname, and do not reclaim DASD space.


The IDCAMS keyword allows you to perform IDCAMS DELETEs and DEFINEs for VSAM data sets in a job step instead of a previous job step.

Note

When the IDCAMS keyword is used with Reorg and Copy functions the DELETE/DEFINE statements should delete and define the shadow data sets.

You can specify the IDCAMS keyword as follows:

  • IDCAMS(input) specifies the ddname of the input data set. The input file is a sequential file (or a member of a PDS) that contains IDCAMS statements.
  • IDCAMS(input,output) specifies the ddnames of the input data set as well as the output data set for the IDCAMS utility. The output file is usually a SYSOUT data set. If the output parameter is omitted, the output is sent to the BMCMSG data set.
  • When you specify IDCAMS(*) or IDCAMS(*,output), also include an AMSPDS DD statement that references the PDS that contains the IDCAMS DELETE/DEFINE statements. Specify the data set name of the PDS only; do not specify the member name. The Index Build function selects the members that match the index DBD ddnames. The Reorg function selects the members that match the main database, primary index, and secondary index DBD ddnames. The Reload function selects the members that match the main database and primary index DBD ddnames.

The ddnames you specify with the IDCAMS keyword must be in the JCL.

Note

The input ddname cannot be SYSIN. The output ddname cannot be SYSPRINT or SYSOUT.

If you specify the IDCAMS keyword, you must specify an input file. The output file is optional.

If IDCAMS issues a return code other than 0 or 8, the BMC reorganization job terminates. Return code 8 indicates an attempt to delete a non-existent file.

Note

If you are not dynamically allocating the target/shadow database data sets (by using the DYNALLOC keyword), the data sets must be included in the JCL.

This section contains the following topics:

Related topic

Keyword descriptions—user-controlled options

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*