Use the "CICS® VR Undo logs assignment" panel to access the "CICS VR
Undo logs management" panel, which you can use to add a new undo log association
or modify an existing undo log association.
Before you begin
To create a new undo log association using the "CICS VR Undo
logs assignment" panel, press F5, Add.
To modify an existing undo
log association using the
"CICS VR Undo logs assignment" panel, type
S,
select, against the association or associations that you want to modify, and
press F6, Alter. For example:
Figure 1. CICS VR Undo
logs assignment panel: selecting associations
Administrate View Help
------------------------------------------------------------------------------
DWWPPULA CICSVR Undo logs assignment Row 1 to 8 of 8
Select one association, then select an action. Or, use Add action to register
new association.
S Value Type Undo log name Time (GMT)
S CICSMVS7 HLQ CM7.UNDOLOG 08.181 15:13:12
S CICSVR2 HLQ TEST.TST2.UNDOLOG 08.181 15:13:17
_ AT* JOBNAME DWW.USER.UNDOLOG 08.185 16:11:08
S ATEST2* JOBNAME TEST.TST2.UNDOLOG 08.181 15:14:05
_ ATEST1 JOBNAME TEST.TST1.UNDOLOG 08.179 16:01:43
S AAAA USERID DWW.USER.UNDOLOG 08.185 15:35:24
_ APROD* JOBNAME PROD.UNDOLOG 08.184 13:17:31
_ TESTUSER USERID TEST.TST1.UNDOLOG 08.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
When you press F5, Add, or F6, Alter, the
"CICS VR Undo
logs management" panel is displayed:
Figure 2. CICS VR Undo
logs management panelDWWPPULM CICSVR Undo logs management
Choose association type by pressing PF4, SwType, type the value, specify
undo log name prefix and press Enter. Or, press F12 to cancel request.
Association type . . : USERID
Association value . . . ________
Undo log name prefix __________________ .UNDOLOG
Command ===>
F1=Help F4=SwType F7=PrevItem F12=Cancel
If you are creating a new undo log association, the association value
and undo log name prefix are blank. If you are modifying existing undo log
associations, the existing parameters for the first association are filled
in, and the correct association type is shown.
About this task
Undo log associations explains the
meaning of each parameter and the rules that CICS VR uses to match job information to
associations. For detailed help for any of the fields, move the cursor to
the field and press F1.
To create or modify undo log associations, follow
these steps:
Procedure
- Use the information in Undo log associations to
plan your new undo log associations or your changes.
- Do not set up conflicting associations. If more than
one association can be matched to the same job, the associations must specify
the same undo log name; otherwise, CICS VR undo logging cannot proceed.
- If you want to use high-level qualifier associations to determine
the undo log, and you update multiple VSAM spheres in the same job, make sure
that all the VSAM spheres listed in the job have a high-level qualifier association,
and that they specify the same undo log.
When you are creating a new undo log association, CICS VR notifies
you if the association that you try to create is identical to an existing
association. However, CICS VR cannot determine whether two associations conflict
until the job responsible for the conflict has been submitted. Also, CICS VR cannot
determine whether the associations for multiple VSAM spheres are correct until
processing starts against the first VSAM data set that is different from those
encountered previously in the job. To avoid processing errors, plan your associations
carefully beforehand.
- Before creating or modifying any undo log association, make sure
that no CICS VR
batch jobs are currently running. Your changes take effect immediately,
and can affect running CICS VR batch jobs that involve undo logging.
- To specify or change the association type, press F4, SwType, to
loop through the three possible types, USERID, JOBNAME, or HLQ.
- Specify, or overtype to change, the association value.
- For the USERID association type, the value is an exact user
ID under which matching jobs run.
- For the HLQ association type, the value is an exact high-level
qualifier for a VSAM sphere name to which matching jobs relate.
- For the JOBNAME association type, the value is the job name
prefix of matching jobs. The value can be an exact job name prefix
or it can be a mask ending with an asterisk (*) as a wildcard. Undo log associations explains
how matching takes place when masks are used.
- Specify or overtype to change the undo log name prefix. This
undo log is used when the association applies for a submitted job. The prefix
can be up to 18 characters, and CICS VR appends .UNDOLOG to
form the complete undo log name. You can use the name of an existing
undo log or specify a new undo log name. If you specify a new undo log name,
you do not take any additional actions to create or activate the new undo
log.
- Press Enter to create or modify the association. The
association is stored in the RCDS, and it is available to CICS VR immediately
for matching.
- If you are modifying more than one association, repeat this process
for the rest of the associations. If you want to return to a previous
association, press F7, PrevItem. When you have finished
modifying all the associations that you selected, CICS VR returns to the "CICS VR Undo
logs assignment" panel, where your changed associations are displayed.