Filtering the VSAM sphere list by instance identifiers
You can filter the VSAM spheres listed in the VSAM sphere list. A VSAM sphere is defined as belonging to an instance (CICS®, DFSMStvs, and CICS® VR) when logging has been performed for the VSAM sphere by the specific instance.
Select option 4 from the pull down menu as described in Using the VSAM sphere list View pull-down menu to
display the CICS® VR
VSAM sphere list instance identifier filter
secondary window.
CICSVR VSAM sphere list instance identifier filter
Enter up to ten CICS APPLIDs, TVSNAMEs, and CICSVR IDs, then press Enter.
Any VSAM sphere that is on the CICSVR VSAM sphere list, and is
defined to one of the specified instance identifiers, is on the
filtered CICSVR VSAM sphere list.
--------------------- VALUE --------------------
CICS APPLID (cccccccc) ________ ________ ________ ________ ________
________ ________ ________ ________ ________
TVSNAME (nnn) . . . . ___ ___ ___ ___ ___
___ ___ ___ ___ ___
CICSVR ID (Rggggnn) . _______ _______ _______ _______ _______
_______ _______ _______ _______ _______
Command ===> ____________________________________________________________
F1=Help F12=Cancel
Use this secondary window to filter the VSAM spheres previously listed on the VSAM sphere list, Using the VSAM sphere list View pull-down menu, based on the ID of the instances to which the VSAM spheres are defined (CICS® APPLID, TVSNAME, and CICS® VR ID).
For example, if a CICS® region with an APPLID of CICSPROD runs an application and performs forward recovery logging for VSAM sphere TEST.VSAM.SPHERE, CICS® VR registers VSAM sphere TEST.VSAM.SPHERE as belonging to CICS® APPLID instance CICSPROD.
VSAM sphere listpanel after successful filtering: Sphere list filtered by specified Instance ID. On return to the
CICS® VR VSAM sphere list instance identifier filtersecondary window, the specified instance IDs values are kept.
- CICS® APPLID
- In the CICS® APPLID
fields, enter the name of a CICS® instance. Any VSAM sphere that was previously listed
on the CICS® VR
VSAM sphere list, and is defined to the entered instance, is displayed on
the filtered CICS® VR
VSAM sphere list.
You can specify up to ten CICS® APPLIDs, where cccccccc is the CICS® APPLID of a CICS® instance that is specified in the CICS® APPLID system initialization parameter.
- TVSNAME
- In the TVSNAME fields, enter the name of a DFSMS™ Transactional VSAM Service (DFSMStvs)
instance. Any VSAM sphere that was previously listed on the CICS® VR VSAM
sphere list, and is defined to the entered instance, is displayed on the filtered CICS® VR
VSAM sphere list.
You can specify up to ten TVSNAMEs, where nnn is the TVSNAME of a specific DFSMStvs instance defined in the TVSNAME definition in the IGDSMSxx PARMLIB member.
- CICSVR ID
- In the CICSVR ID fields, enter the name of a CICS® VR instance. Any VSAM sphere that
was previously listed on the CICS® VR VSAM sphere list, and is defined to the entered
instance, is displayed on the filtered CICS® VR VSAM sphere list. You can specify
up to ten CICS® VR
IDs.
The CICSVR ID for a specific CICS® VR instance is displayed in the text of message DWW245I, on the system console, when the CICS® VR address space is initialized. Also, you can obtain the CICSVR ID value by issuing the DISPLAY SMS,CICSVR operator command.
For example, the DISPLAY SMS,CICSVR operator command produces a result similar to the following:DISPLAY SMS,CICSVR - JOB STATUS APPLID AND NUMBER OF JOBS USING BATCH LOGGING: SYSNAME: MVV3 .RPROD04 0 0 0In this example of the results produced by the DISPLAY SMS,CICSVR operator command, the CICS® VR instance ID for the system is referred to as the APPLID, where:Symbol Meaning . CICS® VR constant value R CICS® VR constant value PROD CICS® VR group name suffix defined on the system 04 System number If you want to filter the VSAM sphere list, only displaying VSAM spheres defined to the .RPROD04 CICS® VR instance, you specify the CICS® VR ID without the first "." character as input to the CICS® VR ID field. For this example, you enter RPROD04 on the CICS® VR ID input field, where:Symbol Meaning R CICS® VR constant value gggg CICS® VR group name suffix defined on the system nn System number Here is an example of entering RPROD04 as input to the CICS® VR VSAM sphere list instance identifier filter:Figure 2. CICS® VR VSAM sphere list instance identifier filter secondary window example CICSVR VSAM sphere list instance identifier filter Enter up to ten CICS APPLIDs, TVSNAMEs, and CICSVR IDs, then press Enter. Any VSAM sphere that is on the CICSVR VSAM sphere list, and is defined to one of the specified instance identifiers, is on the filtered CICSVR VSAM sphere list. --------------------- VALUE -------------------- CICS APPLID (cccccccc) ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ TVSNAME (nnn) . . . . ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ CICSVR ID (Rggggnn) . RPROD04 _______ _______ _______ _______ _______ _______ _______ _______ _______ Command ===> ____________________________________________________________ F1=Help F12=Cancel
- You can use the global search characters asterisk '*' and percent sign '%' to specify a pattern for an instance identifier. The asterisk '*' represents any number of characters and the percent sign '%' represents a single character. For example, to filter the list of VSAM spheres so that only spheres defined to a CICS® APPLID beginning with characters "PROD" are listed, you can specify "PROD*" in a CICS® APPLID input field.
- A VSAM sphere that was listed on the previous CICS® VR VSAM sphere list has to be defined
to only one of the specified instances to be included on the filtered CICS® VR
VSAM sphere list. For example, if you enter PROD1 and PROD2 on
the CICS APPLID input fields, any VSAM sphere that
was previously listed on the CICS® VR VSAM sphere list and is defined to CICS® instance
PROD1, PROD2, or both is displayed on the filtered CICS® VR VSAM sphere list.
In another example, if you enter PROD1 and PROD2 on the CICS APPLID input fields and also enter 001 on the TVSNAME input field, any VSAM sphere that was previously listed on the CICS® VR VSAM sphere list and is defined to either CICS® APPLID PROD1 or PROD2, or TVSNAME instance 001 is displayed on the filtered CICS® VR VSAM sphere list.
- CICS® VR records the instances to which a VSAM sphere is defined during a log of logs scan (for CICS® and DFSMStvs). Therefore, you might want to run a log of logs scan before using the CICS® VR VSAM sphere list instance identifier filter if a log of logs scan has not been run recently.