Understanding the z/OS PAS JCL statements


The following table provides a description of the z/OS PAS proc statement, the PAS EXEC statement, and the Extractor DD statements that are shown in Examples of the instructions in the BBILIB member BBMPAS.


JCL statement

Description

//MVSPAS PROC

specifies symbolic parameters for the z/OS PAS proc

For a detailed explanation of each parameter, see z/OS PAS library member.

//PAS EXEC

specifies the program name (PGM=BBM9DA00)

A TIME parameter should be large enough to prevent the possibility of a timeout (use TIME=1440, if allowed).

The PARM subparameters are all symbolic and use the same values that are defined for the corresponding parameter in the proc statement. For a detailed explanation of each of these parameters, see z/OS PAS library member.

The REGION parameter is symbolic and uses the same value that is defined for the corresponding RGN parameter in the proc statement. (See Examples of the instructions in the BBILIB member BBMPAS for more information.)

//STEPLIB DD

defines a partitioned data set that contains the Extractor load modules

The partitioned data set must be an authorized library, such as hilevel.BBLINK.

This statement should be deleted if BBLINK was added to your system link list. For more information, see Manual customization.

//CMFCPMxx DD

specifies one or more data sets where the Extractor records data that was collected by the CPM submonitor

Do not define this statement if you are recording CPM data to SMF or if you are specifying the data set names on the REPORT Extractor control statement.

To manually customize the CMFCPMxx DD statements to point to your CPM data sets, remove the DUMMY parameter and specify the following statement for each data set that you want to be dynamically allocated during Extractor initialization:

//CMFCPMxx DD DISP=SHR,DSN=&BAVSHLQ..&SYSID..CMFCPMxx

In this statement, xx is a unique value for the allocated data set.

The //CMFCPMxx DD statements can be defined to write simultaneously to the same data sets as the //CMFIPMxx DD statements. If you used the Installation System to configure MainView for z/OS, these statements are defined dynamically, if required.

Specifying alternative data sets is optional; however, alternative data-set support is provided only if alternative data is specified.

For more information about the CPM submonitor, allocating CPM data sets, alternative data set support, and information about the REPORT Extractor control statement, see the CMF MONITOR documentation.

//CMFIPMxx DD

specifies one or more data sets where the Extractor records data that was collected by the IPM submonitor

Do not define this statement if you are recording IPM data to SMF or if you are specifying the data set names on the REPORT Extractor control statement.

To manually customize the CMFIPMxx DD statements to point to your IPM data sets, remove the DUMMY parameter and specify the following statement for each data set that you want dynamically allocated during Extractor initialization:

//CMFIPMxx DD DISP=SHR,DSN=&BAVSHLQ..&SYSID..CMFIPMxx

In this statement,xx is a unique value for the allocated data set.

The //CMFIPMxx DD statements can be defined to write simultaneously to the same data sets as the //CMFCPMxx DD statements. If you used the Installation System to configure MainView for z/OS, these statements are defined dynamically.

Specifying alternative data sets is optional; however, alternative data-set support is provided only if alternative data is specified.

For more information about the IPM submonitor, allocating IPM data sets, alternative data set support and information about the REPORT Extractor control statement, see the CMF MONITOR documentation.

//CMFDUMP DD

defines a print data set for snapshot dumps

When a program fails in CMF MONITOR, the abend is intercepted by an ESTAE routine and a formatted dump of the failing component is printed.

//CMFLOG DD

defines an optional file that can be used to direct the CMF MONITOR Control Card Log to an alternative data set

The data set for the Control Card Log is dynamically allocated and deallocated as needed when no //CMFLOG DD statement is present. The CMFLOG data set allows for immediate inspection of messages, regardless of how long an Extractor job runs. Dynamic allocation is performed based on the MSGCLASS parameter on the JOB statement for batch jobs or on CLASS A for Started Tasks.

//CMFMSG DD

defines a print data set that contains non-initialization messages for the system

The //CMFMSG DD data set is dynamically allocated to SYSOUT CLASS A when no DD statement is present.

To print this data set, issue a MSGFREE command by using the MVS MODIFY command. The data set is dynamically deallocated and printed, and a new allocation occurs immediately.

//PARMLIB DD

defines a partitioned data set that contains control statement members that are read by the Extractor

The PARMLIB data set must be a fixed-block data set with a logical record length of 80, such as hilevel.UBBPARM.

//BBSECURE DD

is a required statement only if you want to use the security views, SERDEF, SERDEFD, and SERDEFL, to define security parameter definitions for CMF MONITOR and/or MainView for z/OS security resource calls

If specified, the data set name that is defined to the CAS proc BBSECURE statement must also be defined to the PAS proc BBSECURE statement. For information about creating the security data set, see Manual customization.

BMC Software recommends that you define a BBSECURE data set to the PAS proc; otherwise, your system must run with the default security calls that are made for CMF MONITOR or MainView for z/OS.

If you do not define a BBSECURE data set, you must either remove or comment out this statement from the PAS proc. An error results when the BBSECURE DD is present and there is no data set allocated.

The security resource definitions in the BBSECURE data set are used by the CAS and PAS to determine whether security checking should occur for system, product, view, or action access. Defining a BBSECURE data set is only one part of setting up security to function with your external security manager. For more information about customizing security, see Managing security for MainView products.

//BBVDEF DD

defines the view library containing all default views for CMF MONITOR or MainView for z/OS

For more information about this DD statement, see Using MainView products

//BBACTDEF DD

defines the library containing all action and view tables for CMF MONITOR or MainView for z/OS

//PARMFILE DD

defines a VSAM data set that contains:

  • data set names for historical data sets, as defined by means of the DSLIST view For more information, see the CMF MONITOR documentation.

  • user-defined workload definitions created through MainView for z/OS by means of the WKLIST view

This data set is allocated and initially loaded during the customization process.

//HISTDS00 DD //HISTDS01 DD//HISTDS02 DD

defines up to 100 VSAM data sets that make up the regular historical database

For information about defining HISTDSnn DD statements, see Manual customization

The regular historical database is used for historical data support. For information about maintaining these data sets, see Managing historical data sets

//HST1DS00 DD //HST1DS01 DD//HST1DS02 DD

defines up to 100 VSAM data sets that make up the long-term historical database whose records can be displayed in the views listed on the LONGTERM view

HST1DSnn DD statements are defined and maintained in the same way as HISTDSnn DD statements.

//HST2DS00 DD //HST2DS01 DD//HST2DS02 DD

defines up to 100 VSAM data sets that make up the short-term historical database whose records can be displayed in the views listed on the SHORTERM view

HST2DS nn DD statements are defined and maintained in the same way as HISTDS nn DD statements.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

MainView for z/OS 6.1