CA: Process all the log records
Use the CA command to define an existing change accumulation group and create or update the change accumulation data set for that group. Use an automated timer process, such as OPC, to regularly submit your change accumulation job.
Format
Keywords
- GROUP(group name)
- Identifies the name of the change accumulation group. The GROUP
keyword is required. Only one GROUP keyword is allowed for each CA
control statement.
- group name
- Defines the name of the change accumulation group. This name is 1–36 characters.
- ONLY(MVS log stream name)
- Specifies that CICS® VR must consolidate only log
records for the VSAM spheres in the change accumulation group from
the portion of the log stream that is read. Log records from change
accumulation data sets previously created for the same CA group are
not used during change accumulation processing.
- MVS log stream name
- Specifies the name of the MVS log stream that contains the log records that must be consolidated by the CICS VR change accumulation utility. The MVS log stream name is 1–26 characters.
- PREFIX(prefix name)
- Identifies the name of the high level qualifier that is used for
the dynamically created change accumulation output data set. CA creates a unique data set name for each CA output data set using the naming convention, prefix.CAOUTPUT.Dyyyyddd.Thhmmsst, where:
- prefix
- Is the CICS VR data set name, CICSVR_DSNAME_PREFIX, defined in the IGDSMSxx PARMLIB member or the prefix specified in the CA command. If both are present and different, the prefix in the CA command is used.
- CAOUTPUT
- Is a constant to mark this as a CA output data set.
- D
- Is the abbreviation for the date.
- yyyy
- Is the year.
- ddd
- Is the day of the year, in Julian format.
- T
- Is the abbreviation for the time.
- hh
- Is the hour of the day, based on a 24-hour clock.
- mm
- Is the number of minutes.
- ss
- Is the number of seconds.
- t
- Is the tenths of a second.
PREFIX is optional. If specified, it overrides any value specified to the CICS VR server address space. Only one PREFIX keyword is allowed for each CA control statement.
- prefix name
- Defines the name of the high level qualifier that is used for the dynamically created change accumulation output data set. This name is 1 to 8 characters.
- VOLUME(volume)
- Specifies the volume serial number that the change accumulation
data set resides on. The VOLUME keyword is required if the output
data set is not a SMS-managed data set. The data set name generated
by CICS VR change accumulation starts with the
prefix specified in the user prefix.
- volume
- Specifies the volume field, which is 1 - 6 characters.
- UNIT(unit)
- Specifies the device type that the change accumulation data set
resides on. The UNIT keyword is required if the output data set is
not a SMS-managed data set. The data set name generated by CICS VR
change accumulation starts with the prefix specified in the user prefix.
- unit
- Specifies the unit name, which is 1 - 8 characters.
Usage Notes
Consider these points when you use the CA command:
- If the CA command is specified, at least one SPHERE command must be specified in the same job.
- You can specify only one CA command per CICS VR change accumulation group run.
- Use CICS VR change accumulation for CICS forward recovery logs; CICS TS autojournals are not supported.
- If the ONLY keyword is specified, the PREFIX, VOLUME, and UNIT keywords cannot be specified.
- If the ONLY keyword is specified, the name of the change accumulation data set must be specified in the DWWCA DD statement in the change accumulation batch job JCL.
- The MVS log stream name parameter only
needs to be specified in the ONLY keyword if:
- This is the first time a CA job for the specified CA group has been submitted with the ONLY keyword specified.
- The log stream name has changed for the specified CA group.