SAMPLIB members

This appendix contains information on sample library members that you can modify to suit your own business requirements:

CBRSPLCS, which is an example program that invokes the CBRXLCS programming interface.
CBRUXCUA, CBRUXENT, CBRUXEJC, and CBRUXVNL installation exits. For more information on the specific installation exit that is illustrated in each of these SAMPLIB members, see Installation exits.
CBRAPROC, which is used to create member OAM in SYS1.PROCLIB.
CBRSPSIM, CBRSPPIM, CBRSPPIP, CBRSPSXP, and CBRSPPXP, which are JCL samples that can be used for creating import or export list volumes.

The installation exits, as supplied by DFSMSrmm, are linked in SMP/E as reentrant. Installation exits CBRUXCUA and CBRUXVNL must be coded and link-edited on the system as reentrant. If multiple tape libraries are defined to the system, CBRUXENT and CBRUXEJC must also be coded and link-edited on the system as reentrant. To demonstrate this, and to provide multiple library support, the sample jobs for CBRUXCUA, CBRUXVNL, CBRUXENT, and CBRUXEJC are all coded as reentrant. The linkage editor parameters found in the prolog are used for each sample job. If you choose to code the installation exits as nonreentrant, you need to create the JCL to link-edit the exits as nonreentrant.

Note: These SAMPLIB members are available to you as part of z/OS. Refer to them as examples for exits you may write to suit your own storage administration plan objectives.

Additionally, there are five sample JCL examples that are provided to illustrate the format and required files for both the import and export list volume. The JCL is commented with the expected format of each of the required files followed by some sample data, if applicable. The following JCL samples are shipped in SYS1.SAMPLIB:

CBRSPSIM for import list volume (scratch request). See SAMPLIB member CBRSPSIM
CBRSPPIM for import list volume (private request). See SAMPLIB member CBRSPPIM
CBRSPPIP for import list volume (private request). Illustrates IMPORT LIST 02 format for outboard policy management specifications. See SAMPLIB member CBRSPPIP.
CBRSPSXP for export list volume (scratch request). See SAMPLIB member CBRSPSXP
CBRSPPXP for export list volume (private request). See SAMPLIB member CBRSPPXP

Both scratch and private examples are provided; however, in order to allocate a scratch volume in a target library in an installation with multiple libraries, the ACS routines need to direct the device allocation for the scratch mount to a specific library. To accomplish this, use an exclusive storage group for each library. This ensures that based on the storage group selected by the ACS routines, the target library for the export or import operation will be the library selected for the scratch mount request. This is necessary since the import or export list volume must reside in the same library as the logical volumes intended for import or export processing.

To initiate the import or export operation from within the JCL, the specific volser examples invoke the CBRXLCS FUNC=EXPORT or FUNC=IMPORT functions using the CBRSPLCS sample program.