You can use the Undo logs assignment feature to set up multiple undo logs, which are associated with particular user IDs, job name prefixes, or high-level qualifiers of VSAM sphere names. When you submit a VSAM sphere update job that involves undo logging, CICS® VR searches for any matching associations.
When CICS VR finds an association that applies to a submitted job, it writes undo records to the undo log named for the association. If no association is found for the job, records are written to the default undo log that is defined for the system. Only one undo log can be used for each job.
Administrate View Help
------------------------------------------------------------------------------
DWWPPULA CICSVR Undo logs assignment Row 1 to 8 of 8
Select one or more associations, then select an action. Or, use Add action to
register new association.
S Value Type Undo log name Time (GMT)
_ CICSMVS7 HLQ CM7.UNDOLOG 08.181 15:13:12
_ CICSVR2 HLQ TEST.TST2.UNDOLOG 08.181 15:13:17
_ AT* JOBNAME DWW.USER.UNDOLOG 08.185 16:11:08
_ ATEST2* JOBNAME TEST.TST2.UNDOLOG 08.181 15:14:05
_ ATEST1 JOBNAME TEST.TST1.UNDOLOG 08.179 16:01:43
_ AAAA USERID DWW.USER.UNDOLOG 08.185 15:35:24
_ APROD* JOBNAME PROD.UNDOLOG 06.184 13:17:31
_ TESTUSER USERID TEST.TST1.UNDOLOG 06.184 13:17:31
Command ===>
F1=Help F3=Exit F4=SwSort F5=Add F6=Alter F7=Bkwd
F8=Fwd F10=Menu bar F11=Delete F12=Cancel
You can sort the list of associations by association value, association type, or undo log name. To sort the list, press F4, SwSort, to loop through the different sorting types. Each time you press F4, the list is repopulated based on the new sorting type.
CICS VR must find only one matching association to select the correct undo log for a particular VSAM sphere update job. You do not have to define all the types of association for each job. For example, if CICS VR finds a user ID association for a particular job, it can select the correct undo log on this basis, and does not need to find a job name prefix association and high-level qualifier association as well.
However, because you can define different types of association, some VSAM sphere update jobs that you submit might match the value for more than one association. For example, a job might be submitted with the job name prefix ATEST2, to update a VSAM sphere with a name that has the high-level qualifier CICSVR2. This job matches more than one association in the sample listing. Because only one undo log can be used for each job, CICS VR applies some matching rules to make sure that it has selected the undo log that you intended for the job:
If an error occurs, the job proceeds without undo logging.
If no matching associations of any type are found for a job, the undo records are written to the default undo log that is defined for the system. The prefix for the default undo log name is specified in the CICSVR_UNDOLOG_PREFIX(prefix) parameter in the active IGDSMSxx member of SYS1.PARMLIB. The default prefix is DWW, so the default name for the default undo log is DWW.UNDOLOG. You must define the default undo log before you submit any job involving undo logging. CICS VR undo logging explains how to define an undo log.