CHANGE.IC command
Use a CHANGE.IC command to modify information contained in an image copy record in the RECON data set.
Subsections:
Syntax
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')
/*