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.