CHANGE.IC command

Use a CHANGE.IC command to modify information contained in an image copy record in the RECON data set.

Subsections:

Syntax

Read syntax diagramSkip visual syntax diagramCHANGE.ICDBD( name)DDN( name)AREA( name)RECTIME( time_stamp)FILESEQ( value)FILESEQ2( value)ICDSN( name)ICDSN2( name)INVALIDVALIDINVALID2VALID2RECDCT( value)UNIT(3400unittype)UNIT2(3400unittype)VOLLIST(,volser)VOLLIST2(,volser)STOPTIME( time_stamp)UDATA(' string')

Keywords

DBD(name)
Required keyword you use to identify the database name of the DBDS whose image copy record is to be modified.
Restrictions for HALDB databases: For HALDB databases, dbname specifies the name of a HALDB partition.
DDN(name) | AREA(name)
Mutually exclusive, required keywords you use to identify the name of the DBDS or DEDB area to which the image copy record being modified is related.
RECTIME(time_stamp)
Required keyword you use to identify the specific image copy data set record to be changed.

Use the Run time marked with an asterisk (*) from the listing of the IMAGE record. The time stamp must be in standard form.

FILESEQ(value)
Optional keyword you use to change the file sequence number in the record of the identified image copy data set.
FILESEQ2(value)
Optional keyword you use to change or add the file-sequence number in the record of the identified duplicate image copy data set.
ICDSN(name)
Optional keyword you use to change the data set name of the identified image copy data set.
ICDSN2(name)
Optional keyword you use to change or add the data set name of the identified duplicate image copy data set in an image copy record.

To change the name of the duplicate image copy data set, a record of the first image copy data set must exist in the RECON data set.

INVALID | VALID
Mutually exclusive, optional keywords that you use to prevent or permit the use of an image copy data set as input to a subsequent run of the Database Recovery utility (DFSURDB0).
INVALID
Prevents the use of the specified image copy data set as input to a subsequent run of the Database Recovery utility. If the invalidated image copy data set is reused, it is automatically marked as valid.
VALID
Permits the use of a previously invalidated image copy data set as input to a subsequent run of the Database Recovery utility.

The Database Recovery utility expects this image copy data set as input unless it is marked as INVALID, in which case the utility expects a duplicate image copy data set as input.

INVALID2 | VALID2
Mutually exclusive, optional keywords that you use to prevent or permit the use of a duplicate image copy data set as input to a subsequent run of the Database Recovery utility (DFSURDB0).
INVALID2
Prevents the use of the specified, duplicate image copy data set as input to a subsequent run of the Database Recovery utility. If the invalidated, duplicate image copy data set is subsequently reused, it is automatically marked as valid.
VALID2
Permits the use of a previously invalidated, duplicate image copy data set as input to a subsequent run of the Database Recovery utility.

If both INVALID2 and VALID2 are specified, the last one specified is used.

RECDCT(value)
Optional keyword you use to change the count of the records in the corresponding image copy data set in the specified image copy record. CHANGE.IC value must be a decimal number up to 2 147 483 647.
UNIT(3400 | unittype)
Optional keyword you use to change the unit type that is recorded in the specified image copy record. The unit type can be up to 8 alphanumeric characters.
UNIT2(3400 | unittype)
Optional keyword you use to change the unit type that is recorded in the specified duplicate image copy record. The unit type can be up to 8 alphanumeric characters.
VOLLIST(volser)
Optional keyword you use to change, in the image copy record, the volume serial numbers of the volumes on which the identified image copy data set resides.
VOLLIST2(volser)
Optional keyword you use to change or add, in the image copy record, the volume serial numbers of the volumes on which the identified duplicate image copy data set resides.
STOPTIME(time_stamp)
Optional keyword you use to specify the time when an image copy has completed. The time stamp must be in standard form and cannot be less than the image copy start time. If this is an HSSP CIC that is in progress, specifying a valid stop time terminates the HSSP CIC and resets the in-progress indicators in the IC record and the DBDS record.
UDATA('string')
Optional keyword you use to specify up to 80 bytes of information about the identified, standard image copy data set. You can use the variable field of this keyword to describe how the standard image copy data set was created. The string value must be enclosed in single quotation marks if blanks or any other special characters are included.

Examples

Example 1: Changing an image copy record

In this example, information in an image copy record that is identified by the DBD, DDN, and RECTIME keywords is to be changed in the RECON data set. The new data set names of both image copy data sets (specified in the ICDSN and ICDSN2 keywords) follow the default naming convention. The volume serial numbers on which the image copy data sets reside are also to be changed as specified in the VOLLIST and VOLLIST2 keywords.

 //CHGIC    JOB
 ⋮
 //SYSIN    DD   *
   CHANGE.IC   DBD(DBDKSDS1)  DDN(DDNKSDS1)  -
     ICDSN(IMS.DBDKSDS1.DDNKSDS1.IC.ICDSN02) -
     ICDSN2(IMS.DBDKSDS1.DDNKSDS1.IC2.ICDSN02)   -
     VOLLIST(ICVOL1,ICVOL2,ICVOL3) FILESEQ2(2)   -
     VOLLIST2(ICVOL4) RECTIME(07092131414323456)
 /*

Example 2: Changing the user data in an image copy record

In this example, information in an image copy record that is identified by the DBD, DDN, and RECTIME keywords is to be changed in the RECON data set. The changed user data is included in the UDATA parameter.

 //CHGIC    JOB
 ⋮
 //SYSIN    DD   *
   CHANGE.IC   DBD(DBDKSDS1)  DDN(DDNKSDS1)  -
     RECTIME(09152104355891200) –
     UDATA(‘RECOVERY POINT FOR ALL PARTITIONS TAKEN ON IMS12 EACH MONTH')
 /*