Library Concatenation - USER, SITE, and SYSTEM

cspm10
A CA SYSVIEW installation is comprised of several types of libraries or data sets. Each data set or library is designed to contain a specific type of data. This is referred to as a library type or libtype.
A library type can consist of multiple data sets. If multiple data sets have been defined, the data sets will be dynamically concatenated when a read request is made for the specified library type. Only one data set can be defined for each data set type. Therefore, a maximum of three data sets can be concatenated.
If defined, the data sets will be concatenated in the following order:
libtype DD DISP=SHR,DSN=user.data.set DD DISP=SHR,DSN=site.data.set DD DISP=SHR,DSN=system.data.set
The following are the possible data set types:
User
User defined data sets that contain definitions or overrides to site or system definitions.
The user data set names are defined and maintained in the user's SYSVIEW profile.
User data sets are optional.
Site
Site defined data sets that contain definitions or overrides to system definitions.
Site data sets are optional.
The site data set names are defined in the SYSVIEW System Configuration Options member: GSVXGSVX
The system configuration options member must be located in the data set referenced by the DDname GSVXSCFG.
The DDname GSVXSCFG is only specified in SYSVIEW service address spaces and utility jobs.
System
System defined data sets that contain definitions or configuration options. The set of system data sets are those data sets that contain the original members delivered during product installation.
System data sets are required.
The system data set names are defined in the SYSVIEW System Configuration Options member: GSVXGSVX
The system configuration options member must be located in the data set referenced by the DDname GSVXSCFG.
The DDname GSVXSCFG is only specified in SYSVIEW service address spaces and utility jobs.
Why do I Want to Define SITE and USER Data Sets?
  • SITE
The usage of site data sets provides the ability to more easily maintain those library members that have been modified or customized.
The site data sets can be reused and carried forward when migrating or updating to a new release of SYSVIEW.
Having a separate site data set that contains only those members that have been modified allows you to quickly identify the members that have been customized. This assumes that the members in the system data sets have not been modified and contain the default configurations and setting that were provided out-of-the-box at installation.
  • USER
The usage of user data sets provides the same benefits as does the site data sets. User data sets allow the individual to have a customized user experience when using the SYSVIEW user interfaces.
Example
:
A user may want to create a personalized menu. In this case, the user would need to define a user PANELLIB data set, create the desired menu and save the menu in the PANELLIB data set.
Are USER, SITE, and SYSTEM Data Sets Required?
A CA SYSTEM data set is required for all library types. USER and SITE data sets are not required. The definition of USER and SITE data sets are always optional.
USER and SITE data sets are not eligible for all library types. The following table shows data set eligibility by library type:
Dsn Data Set Eligibility LibType Suffix User Site System -------- -------- ---- ---- ------ CAPLIB CNM4BCAP Site System CLISTLIB CNM4BCLS User Site System DATALIB CNM4BDAT System HELPLIB CNM4BHLP User Site System MAPLIB CNM4BMAP User Site System MIBLIB CNM4BMIB User Site System PANELLIB CNM4BPNL User Site System PARMLIB CNM4BPRM User Site System PLOTLIB CNM4BPLT User Site System PROFILE CNM4BPRF System REXXLIB CNM4BREX Site System SAMPLIB CNM4BSAM System SCFGLIB CNM4SCFG System SECURITY CNM4BSEC System TEMPLATE CNM4BTMP User Site System
What Parmlib Members are Eligible for USER Data Sets?
The help topic: Parmlib member contents contains a list of parmlib members. Each member listed will contain a general description of the member as well as its intended purpose and data set eligibility.
What Data Sets are Currently Defined?
A list of data sets in-use for the current SYSVIEW session can be viewed using the following commands:
  • LIBS - Product libraries
  • STATUS - Product status
Where do I Define SYSTEM Data Sets?
System data sets are defined in the SYSVIEW System Configuration options member: GSVXGSVX
The system configuration options member must be located in the data set referenced by the DDname GSVXSCFG.
The system data set names are defined using the following options:
System Config LibType Option Data Set Name -------- ------------------- ----------------------------------------- CAPLIB Dsn-System-CAPLIB
sysview
.CNM4BCAP CLISTLIB Dsn-System-CLISTLIB
sysview
.CNM4BCLS DATALIB Dsn-System-DATALIB
sysview
.CNM4BDAT HELPLIB Dsn-System-HELPLIB
sysview
.CNM4BHLP MAPLIB Dsn-System-MAPLIB
sysview
.CNM4BMAP MIBLIB Dsn-System-MIBLIB
sysview
.CNM4BMIB PANELLIB Dsn-System-PANELLIB
sysview
.CNM4BPNL PARMLIB Dsn-System-PARMLIB
sysview
.CNM4BPRM PLOTLIB Dsn-System-PLOTLIB
sysview
.CNM4BPLT PROFILE Dsn-System-PROFILE
sysview
.CNM4BPRF REXXLIB Dsn-System-REXXLIB
sysview
.CNM4BREX SAMPLIB Dsn-System-SAMPLIB
sysview
.CNM4BSAM SECURITY Dsn-System-SECURITY
sysview
.CNM4BSEC TEMPLATE Dsn-System-TEMPLATE
sysview
.CNM4BTMP
Where do I Define SITE Data Sets?
Site data sets are defined in the SYSVIEW System Configuration options member: GSVXGSVX
The usage of site data sets is optional.
The system configuration options member must be located in the data set referenced by the DDname GSVXSCFG.
The site data set names are defined using the following options:
System Config LibType Option Data Set Name -------- ------------------- ----------------------------------------- CAPLIB Dsn-Site-CAPLIB
sysview.site
.CNM4BCAP CLISTLIB Dsn-Site-CLISTLIB
sysview.site
.CNM4BCLS HELPLIB Dsn-Site-HELPLIB
sysview.site
.CNM4BHLP MAPLIB Dsn-Site-MAPLIB
sysview.site
.CNM4BMAP MIBLIB Dsn-Site-MIBLIB sysview.site.CNM4BMIB PANELLIB Dsn-Site-PANELLIB
sysview.site
.CNNM4BPNL PARMLIB Dsn-Site-PARMLIB
sysview.site
.CNM4BPRM PLOTLIB Dsn-Site-PLOTLIB
sysview.site
.CNM4BPLT REXXLIB Dsn-Site-REXXLIB
sysview.site
.CNM4BREX TEMPLATE Dsn-Site-TEMPLATE
sysview.site
.CNM4BTMP
Where do I Define USER Data Sets?
User data sets are defined in the SYSVIEW user profile. Each user has a profile member in the SYSVIEW profile data set. There is only a system profile data set. The usage of user data sets is optional.
The LIBS command can be used to modify the current data set names for user libraries. Entering a data set name sets or defines the data set to the user profile. It does not physically create the data sets.
The following QUERY|SET|MODIFY keywords can be used to view and modify the current data sets defined.
User Profile LibType Keyword Data Set Name -------- ------------ -------------------------------------------- CLISTLIB CLISTLIB HELPLIB HELPLIB MAPLIB MAPLIB MIBLIB MIBLIB PANELLIB PANELLIB PARMLIB PARMLIB PLOTLIB PLOTLIB TEMPLATE TEMPLATELIB
Can Multiple Users Share a Common USER Data Set?
Yes. Multiple users can use the same data set as a USER library. This can be very beneficial or useful when working in a group setting.
Does the CICS Data Collector use USER, SITE, and SYSTEM Data Sets?
The CICS data collector executes within the CICS address space. SITE and SYSTEM defined data sets will be used. USER data sets are not used. There is no concept of a user session in the data collector. Online SYSVIEW user sessions may utilize USER data set that are associated with CICS information.
Sample JCL to create USER and SITE libraries
Sample JCL has been provided in the SAMPLIB data set that can be used to create USER and SITE data sets.
Create USER library data sets sysview.CNM4BSAM(USERLIBS) Create SITE library data sets sysview.CNM4BSAM(SITELIBS)
What are the Data Set DCB Attributes Required for Each Library Type?
The following is a list of required DCB attributes by library type:
LibType Dsorg Recfm Lrecl SeqNo -------- ------ ----- ----- --------- CAPLIB PO|POE FB 80 Yes 73-80 CLISTLIB PO|POE FB 80 Yes 73-80 DATALIB POE FB 80 No HELPLIB PO|POE FB 80 No MAPLIB PO|POE FB 80 No MIBLIB PO|POE FB 80 Yes 73-80 PANELLIB PO|POE FB 100 No PARMLIB PO|POE FB 80 Yes 73-80 PLOTLIB PO|POE FB 80 Yes 73-80 PROFILE PO|POE F 6144 No REXXLIB PO|POE FB 80 No SAMPLIB PO|POE FB 80 No SCFGLIB PO|POE FB 80 Yes 73-80 SECURITY PS F 8906 No TEMPLATE PO|POE FB 80 Yes 73-80
Symbolic Substitution Variables for Data Set Name
Symbolic variable names are available that can be used to provide dynamic substitution for USER, SITE and SYSTEM data set names.
The VLIST command displays a list of available symbolic substitution variables.
The following is a list of symbols for data set substitution:
LibType USER Symbol SITE Symbol SYSTEM Symbol -------- ----------------- ----------------- ----------------- CAPLIB none &SITE_CAPLIB &SYSTEM_CAPLIB CLISTLIB &USER_CLISTLIB &SITE_CLISTLIB &SYSTEM_CLISTLIB DATALIB none none &SYSTEM_DATALIB HELPLIB &USER_HELPLIB &SITE_HELPLIB &SYSTEM_HELPLIB MAPLIB &USER_MAPLIB &SITE_MAPLIB &SYSTEM_MAPLIB MIBLIB &USER_MIBLIB &SITE_MIBLIB &SYSTEM_MIBLIB PANELLIB &USER_PANELLIB &SITE_PANELLIB &SYSTEM_PANELLIB PARMLIB &USER_PARMLIB &SITE_PARMLIB &SYSTEM_PARMLIB PLOTLIB &USER_PLOTLIB &SITE_PLOTLIB &SYSTEM_PLOTLIB PROFILE none none &SYSTEM_PROFILE REXXLIB none &SITE_REXXLIB &SYSTEM_REXXLIB SAMPLIB none none &SYSTEM_SAMPLIB SCFGLIB none none &SYSTEM_SCFGLIB SECURITY none none &SYSTEM_SECURITY TEMPLATE &USER_TEMPLATE &SITE_TEMPLATE &SYSTEM_TEMPLATE
What Control Statements are Available to Customize Parameter Members?
The usage of control statements within parameter or text based source members provides enhanced functionality. Reference the help topic: Control statements - parameter members to enhance the possibilities with regard to Library Concatenation.
In particular, the )INCLUDE control statement allows for creative ways to include data from other members and data sets.
How do I Create My Own Menu?
A user may want to create a personalized menu. In this case, the user would need to:
  • Define a user PANELLIB dataset if it does not exist
  • Create the desired menu
    Reference help topic Menu customization for the menu customization process
  • Save the menu in the user PANELLIB data set
To display a personalized menu, reference the MENU Command.
How do I Augment the Primary Menu?
A SITE or SYSTEM menu can be augmented with additional user content. The default primary menu MENUPRIM could have user specific data appended to the end of the existing menu. In this case, the user needs to:
  • Define a user PANELLIB dataset if it does not exist
  • Create a user menu, for this example we'll call it MENUMAIN
  • Include MENUPRIM (default SYSVIEW primary menu) from the SITESYSTEM concatenation
  • Append the information you want displayed, like common commands, dataset lists, or favorite URLs.
EDIT MY.SYSVIEW.USER.CNM4BPNL(MENUMAIN) Command ===> ****** ******************************************* Top of Data ************ 000001 )INCLUDE MENUPRIM SITESYSTEM 000002 D 000003 F My commands 000004 _ SYSVIEW Topics 000005 TOPICS 000006 D 000007 F My datasets 000008 _ SYSVIEW User datasets 000009 DSCAT MY.SYSVIEW.USER 000010 _ General JCL 000011 DSCAT MY.JCL 000012 _ SYSVIEW specific JCL 000013 DSCAT MY.SYSVIEW.JCL 000014 _ REXX 000015 DSCAT MY.REXX 000016 D 000017 F My URLs 000018 CA Support Online - http://support.ca.com 000019 IBM zOS Library - http://www-03.ibm.com/systems/z/os/zos/b ****** ****************************************** Bottom of Data **********
  • Save the menu in the PANELLIB data set
The following QUERY|SET|MODIFY keyword can be used to view and modify the current data sets defined. If you want to replace your default primary menu with the newly created MENUMAIN use the SET PRIMARYMENU keyword. To display a personalized menu reference the MENU Command.