Space banner

   

This space provides the same content as before, but the organization of the home page has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

z/OS PAS PROC statement parameters

The following table explains each parameter that is available for use with the PROC statement in the z/OS PAS started task procedure:

ParameterDescription

AHS

The optional AHS parameter specifies the suffix of the BBUTAHxx PARMLIB member that is used for MainView for USS Ad Hoc Data Management.

This parameter is ignored if MainView for USS is not installed or not enabled.

This parameter uses the following syntax:

AHS={xx | S0}

The default is S0.

Note

This parameter is only available as a JCL PARM specification in MainView for USS version 6.1 or later.

BAVSHLQ

The required BAVSHLQ parameter defines the high-level qualifier for the VSAM data sets that are used for historical data and internal and user-defined system workloads.

This parameter uses the following syntax:

BAVSHLQ=hlq

BBCHILV

The required BBCHILV parameter defines the high-level qualifier for the product libraries.

This parameter uses the following syntax:

BBCHILV=hlq

BBLINK

The optional BBLINK parameter defines the name to be assigned to the BBLINK data set.

This parameter uses the following syntax:

BBLINK=name

Note

If BBLINK is in your system link list, this parameter and the STEPLIB DD statement should be removed.

BBSOUT

The required BBSOUT parameter defines a valid SYSOUT class for started tasks.

This parameter uses the following syntax:

BBSOUT=class

BBX

The optional BBX parameter specifies the name of the BBX SubSystem to be used.

This parameter uses the following syntax:

BBX=name

The default is BBX=BBXS.

Warning

This parameter is designed for diagnostic purposes only. Specify this parameter only when instructed to do so by BMC Customer Support.

CASWAIT

The optional CASWAIT parameter (used for CMF MONITOR and MainView for z/OS only) specifies the amount of time that the PAS should wait for the CAS to start, both during initial PAS startup and if the CAS terminates while the PAS is executing.

This parameter uses the following syntax:

CASWAIT=nnnn

nnnn can be any number of minutes from 0 to 9999. The default is 10 minutes. If you specify CASWAIT=0, the initialization process does not retry the connection to the CAS.

CFCACHE 

The optional CFCACHE parameter specifies whether the Coupling Facility Data Collector (CFAC) gathers additional data for cache structures.

Note

To obtain this information, you need to make an additional CF API (IXLMG) call for each cache structure.

Specifies whether the Coupling Facility Data Collector (CFAC) gathers additional data for cache structures. Since obtaining this information requires making an additional CF API (IXLMG) call for each cache structure, the default is not to obtain this information.

When CFCACHE=Y has NOT been requested, various fields in Coupling Facility Structure views relating to the cache structure activity, such as Directory Reclaims, are zero (0).

This parameter uses the following syntax:

CFCACHE={Y | N}

The default is N.

Note

This parameter is valid only when specified by using a MODIFY command. It is not valid in the JCL parameter field.

CMDID

The optional CMDID parameter defines a single character to be used as the "command id" character for use when issuing commands to the PAS or SYSPROG. Commands prefixed with the command id character are routed to the PAS. Commands prefixed with the command id character

repeated twice are routed to SYSPROG.

This parameter uses the following syntax:

CMDID=symbol

You can use the CMDID value as a quick method for issuing commands. You must manually add the CMDID parameter to the PAS procedure statement to enable this support. Valid operands are as follows:

 

)

>

&

?+

!

*

:

^

#_

.

-

<

%

'"

(

+

=

/

@

Warning

Do not use a character that is being used for some other subsystem or is used as the backspace character. The not sign (^) is the default backspace character for JES2.

Certain operands might need to be enclosed within quotation marks to work in your environment. Alternatively, operands can be specified as a two-digit hexadecimal representation.

For information about using the MODIFY command to control the z/OS PAS, see Controlling z/OS PAS operation.

CPM
The optional CPMparameter (used for CMF MONITOR and MainView for z/OS only):
  • Specifies the two-character suffix of the CMFCPMxx control statement member in the data set to which the PARMLIB DD statement points

  • Indicates not to run the CPM mode samplers

This parameter uses the following syntax:

CPM={xx | 00 | STOP}

Warning

CPM=STOP terminates the address space unless IPM monitoring mode is active.

The default is 00.

The control statement member contains Extractor REPORT and sampler control statements. This member controls the operation of the CPM mode samplers and defines the resources that the Extractor monitors.

CPM mode samplers execute either when a MODIFY command is issued or when the CPM parameter is used. Sample control statement members are in the hlq.UBBPARM data set that was created by MainView Customization.

The CPM mode control statement member that the Extractor uses can be changed while the Extractor is active by using the MODIFY command; for more information, see Controlling z/OS PAS operation.

CXEN
The optional CXEN parameter specifies whether the CMF Extractor can issue an Enqueue, preventing another extractor from running. CXEN=Y is required if SMF=YES is specified on the CMFCPMxx or CMFIPMxx REPORT control statement. The purpose of this parameter is to allow more than one CMF PAS to run on the same system. Only one PAS can specify CXEN=Y (and hence write to SMF). All others must specify CXEN=N.

CXEN={ Y | N}

The default is Y (Yes), which allows enqueue sampling, workload sampling, and writing to SMF data sets. You can run more than one CMF Extractor on your system at a time. However, only one Extractor can sample workload data or enqueue data.

Note

Because of the associated overhead, you should not run multiple Extractors unless it is required in trial situations to evaluate MainView for z/OS. CXEN=N should be defined to a trial Extractor, if necessary.

DC

This parameter indicates whether or not the normal Data Collectors should be started. CPM and IPM are used to indicate that the Data Collectors should be started using the associated CMF MONITOR CPM or IPM Extractor session. START uses the CMF MONITOR CPM session.

This parameter uses the following syntax:

DC={ START | STOP | CPM | IPM}

The terms NORMAL Data Collectors and REGULAR Data Collectors are used interchangeably for the same set of Data Collectors that are based on the interval specified
via the CMFCPMxx or CMFIPMxx PARMLIB member.

Note

This parameter does not control the CMF Extractor.

DCDL
The optional DCDL parameter specifies the suffix of the BBDTDCxx PARMLIB member that is used to disable the Data Collectors for MainView for z/OS, MainView for USS, and CMF MONITOR Online.

To use this member (default or alternate name), you must copy the BBDTDCDL PARMLIB member to the appropriate UBBPARM Data Set and then modify it.

The distributed member in the BBPARM Data Set should remain unaltered.

This parameter uses the following syntax:

DCDL={xx | DL}

The default is DL.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 6.1 or later.

DYNSAMP

The optional DYNSAMP parameter specifies the use of dynamic sample timing for the Data Collectors. Data collector sampling is once a second, with various Data Collector called every second, every four seconds, every 15 seconds, etc. Prior to this parameter, after each set of Data Collector calls, the PAS would wait a full second before the next sample cycle.

This parameter uses the following syntax:

DYNSAMP={Y | N}

The default is Y.

With DYNSAMP=Y (default), the wait will be reduced by the elapsed time the previous Data Collector sample cycle took. For example, if a Data Collector sample cycle took 150 milliseconds, the wait until the next cycle would be 850 milliseconds instead of a full second. This allows more samples to be taken during an interval.

DYNSAMP=N is provided as a fallback if unexpected effects of the new sample timing are encountered.

EM
The required EM parameter (used for MainView for z/OS only) specifies the two-character suffix of the PWSCPMxx control statement member that you want the MainView for z/OS Exception Monitor to use.

The suffix for the PWSCPMxx control statement can be specified by the AEWSTART=xx parameter in the SYSPROG Services $$INSYS0 PARMLIB member. The value specified by the EM=xx parameter overrides the AEWSTART value.

If the EM parameter is omitted or coded as simply EM=, the value in the AEWSTART parameter is used. If neither EM=xx nor AEWSTART=xx is specified, AEW is NOT started.

Note

This parameter is only used by MainView for z/OS. If MainView for z/OS is not installed, this parameter is ignored.

This parameter uses the following syntax:

EM={xx}

There is no default.

FMNTHFS
The optional FMNTHFS parameter specifies whether the MainView for USS Mounted File System Data Collector should collect the detailed HFS or not. This parameter takes the place of specifying the HFS=YES or HFS=NO on the FMNT statement in the BBDTDCxx PARMLIB member.

Note

This parameter is only used by MainView for USS. If MainView for USS is not installed, this parameter is ignored.

This parameter uses the following syntax:

FMNTHFS=( YES|NO}

The default is YES.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 6.1 or later.

HISTCOMP
The optional HISTCOMP parameter specifies whether the history data files should be compressed before being written out.

This parameter uses the following syntax:

HISTCOMP ={ YES | NO}

The default is YES.

IPM 
The optional IPM parameter specifies the suffix of the CMFIPMxx control statement member you want the CMF Extractor to use when running in IPM mode. Change this to the IPM member that you want to start.

CMF control statement members are stored in the parameter library allocated by the DDName PARMLIB. A sample set of control statements for the CMF Extractor samplers commonly used in IPM mode is located in the CMFIPM00 member of the hilevel.BBPARM library.

This parameter uses the following syntax:

IPM={xx | STOP}

The default is STOP.

Note

You should add this parameter to the PAS started task procedure only if you always want to start the IPM monitor when the CPM monitor starts. Member CMFIPM00 is built as part of the installation process. If you do not want the IPM monitor to run, specify IPM=STOP.

JST 
The optional JST parameter specifies the suffix of the BBDJSTxx PARMLIB member used for the MainView for z/OS Job Step Data Collector.

This parameter uses the following syntax:

JST = xx

The default is 00.

Note

This parameter is only available as a JCL PARM specification for MainView for z/OS version 3.2 or later.

LPARINAC 
The optional LPARINAC parameter specifies whether the MainView for z/OS LPAR Data Collector should gather information on LPARs that are inactive.

By default, inactive LPARs appear in various LPAR views with very little useful data. Specifying LPARINAC=NO eliminates inactive LPARs from appearing in the LPAR views.

This parameter uses the following syntax:

LPARINAC={ YES | NO }

The default is YES.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 6.1 or later.

LTDC 
The optional LTDC parameter specifies the suffix of the BBDTLTxx PARMLIB member that is used to enable the Long-term Data Collectors. The normal Data Collectors must also be started, that is, DC=START.

This parameter uses the following syntax:

LTDC={xx | DC}

The default is DC.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 3.2.

MSDP 
The optional MSDP parameter specifies the suffix of the BBDTMSxx PARMLIB member that provides the defaults for MVScope.

Note

This parameter is ignored if the MainView for z/OS product is not installed.

This parameter uses the following syntax:

MSDP={xx | DP}

The default is DP.

This value can be altered at any time by using a MODIFY command.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 3.2 or later.

MSCGSC
The optional MSCGSC parameter specifies whether MVScope Granular Security is to be enabled, which prevents a user from mapping a program if they don't have read access to the program library dataset. If the feature is turned on, you may see a userid read access error message on the MSMONSET view while running the MVScope monitor command. The PAS log will have BBDDM039I messages to indicate which dataset the userid does not have read access to.
This parameter uses the following syntax:

MSCGSC={Y | N}

The default is N.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 6.1 or later.

OMVSLIM 
The optional OMVSLIM parameter specifies the number of short running OMVS forked address spaces that can occur in a single interval before Address Space records are no longer created for them.

This parameter uses the following syntax:

OMVSLIM=nnnnn

The default is OMVSLIM=1000.

Note

This parameter is only used by MainView for z/OS version 3.0 or later and CMF version 5.8 or later, with the fix for APAR BAY8788 installed.

This value can be altered at any time by using a MODIFY command.

PRCSTHR 
The optional PRCSTHR parameter specifies whether the MainView for USS Process Data Collector should collect the thread data or not.

This parameter takes the place of specifying THREAD=YES or THREAD=NO on the PRCS statement in the BBDTDCxx PARMLIB member.

This parameter is ignored if MainView for USS is not installed or not enabled.

This parameter uses the following syntax:

PRCSTHR={YES | NO}

The default is NO.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 6.1 or later.

PVTLOW 
The optional PVTLOW parameter specifies the threshold of storage (in kilobytes) in the 24-bit private area of the Product Address Space.

If the amount of contiguous free storage in the 24-bit private area of the PAS falls below this value, a warning message will be issued. Specifying a value of zero disables this check.

This parameter uses the following syntax:

PVTLOW=nnnn

The default is PVTLOW=512.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 3.2 or later.

This value can be altered at any time by using a MODIFY command.

PVTHIGH 
The optional PVTHIGH parameter specifies the threshold of storage (in megabytes) in the extended private area of the Product Address Space.

If the amount of contiguous free storage in the extended private area of the PAS falls below this value, a warning message is issued. Specifying a value of zero disables this check.

This parameter uses the following syntax:

PVTHIGH=nnnn

The default is PVTHIGH=64.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 3.2 or later.

 This value can be altered at any time by using a MODIFY command.

QRJ 
The optional QRJ parameter specifies the suffix of the BBDTQRxx PARMLIB member used to provide Job execution state information for the JESTATR view.

This parameter is ignored if MainView for z/OS is not installed or not enabled.

This parameter uses the following syntax:

QRJ=xx

The default is QRJ=J0.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 3.2 or later.

This value can be altered at any time by using a MODIFY command.

RGN
The required RGN parameter assigns a region size of 32 megabytes.

This parameter uses the following syntax:

RGN=32

RLS 
The optional RLS parameter specifies the suffix of the BBDTRLxx PARMLIB member that is used to provide the Data Set filtering parameters for the VSAM RLS Data Collector.

This parameter uses the following syntax:

RLS=xx

The default is RLS=SI.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 3.2 or later.

SAS 
The optional SAS parameter specifies the suffix of the BBUTSAxx PARMLIB member used for the MainView for USS Action Security Controls.

This parameter is ignored if MainView for USS is not installed or not enabled.

This parameter uses the following syntax:

SAS=xx

The default is SAS=S0.

Note

This parameter is only available as a JCL PARM specification in MainView for USS version 6.1 or later.

SRH
The optional SRH parameter specifies the suffix of the BBUTSHxx PARMLIB member used for the MainView for USS Required and Continuously File Systems.

This parameter is ignored if MainView for USS is not installed or not enabled.

Note

If you omit this parameter, the default member name, BBUTSRH0, is used. If you specify any value, BBUTSHxx is used.

This parameter uses the following syntax:

SRH=xx

The default is SRH=H0.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 6.1 or later.

SRP 
The optional SRP parameter specifies the suffix of the BBUTSPxx PARMLIB member used for the MainView for USS Required Process PARMLIB member.

This parameter is ignored if MainView for USS is not installed or not enabled.

Note

If you omit this parameter, the default member name, BBUTSRP0, is used. If you specify a value, BBUTSPxx is used.

This parameter uses the following syntax:

SRP=xx

The default is SRP=P0.

Note

This parameter is only available as a JCL PARM specification in MainView for USS version 6.1 or later.

SSID 
The required SSID parameter specifies the subsystem ID of the CAS to which the z/OS PAS should connect.

This parameter uses the following syntax:

SSID=xxxx

For a PAS to connect to a CAS, the SSID values in both the CAS and PAS startup procedures must be the same.

Note

The CAS is started as a separate address space from the z/OS PAS and must be initialized before the z/OS PAS is initialized.

STDC 
The optional STDC parameter specifies the suffix of the BBDTSTxx PARMLIB member used to start the Short-term Data Collectors.

The normal Data Collectors must also be started, e.g., DC=START.

This parameter uses the following syntax:

STDC={xx | NO}

The default is NO.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 3.1 or later and CMF Monitor version 5.9 or later.

TSP 
The optional TSP parameter specifies the suffix of the BBATSPxx PARMLIB member used to enable or disable individual products that can run within the MainView for z/OS or CMF MONITOR Online Product Address Space.

This parameter uses the following syntax:

TSP=xx

The default is TSP=00.

Note

This parameter is only available as a JCL PARM specification in MainView for z/OS version 3.2 or later and CMF Monitor version 6.0 or later.

TZOVRLAP 
The optional TZOVRLAP parameter (used by CMF MONITOR CPM and IPM sessions only) specifies the recording of CMF SMF records when the Time Zone offset is changed and an overlap exists in the local time.

This parameter uses the following syntax:

TZOVRLAP= RECORD | DISCARD

  • TZOVRLAP=RECORD (default) causes all output records to be written. Consequently, two sets of interval records cover one hour when the Time Zone offset is changed backwards (that is, an hour earlier).

  • TZOVRLAP=DISCARD causes the CMF SMF records to be discarded for the intervals that follow the change that overlap the previously recorded intervals.

This parameter is applicable only to CMF MONITOR CPM and IPM sessions that are writing SMF records (to SMF or to the CMFCPMx or to CMFIPMx DDs). Otherwise, this parameter is ignored.

This value can be altered at any time by using a MODIFY command.

UBBPARM 
The required UBBPARM parameter defines the name to be assigned to the user parameter library.

This parameter uses the following syntax:

UBBPARM=name

USEZIIP 
The optional USEZIP parameter (used by products that are enabled to offload work to zIIP processors) specifies whether eligible CPU processing should be offloaded to zIIPs if zIIPs are online.

This parameter uses the following syntax:

USEZIIP=( Y | N)

The default is Y (Yes).

This value can be altered at any time by using a MODIFY command, which gives you control over whether zIIP-eligible processing should be offloaded from standard CPs to zIIPs.

Note

This parameter is only used by MainView for z/OS 2.9 or later, CMF 5.7 or later, or MainView SYSPROG Services 3.5 or later. If none of these products are installed, this parameter is ignored.

XDM 
The optional XDM parameter indicates whether the z/OS PAS should execute in extended diagnostic mode (XDM). This mode produces additional messages and suspends some PAS error-recovery processing, and is not recommended for normal operation.

This parameter uses the following syntax:

XDM={Y | N}

Warning

Specify XDM=Y only when instructed to do so by BMC Customer Support. The XDM=Y parameter disables certain error-recovery processes that could severely impact your system.

The default is N (No).

XDS 
The optional XDS parameter (used for CMF MONITOR only) specifies the suffix of the CMFXDSxx control statement member that you want the CMF MONITOR to use when starting the CMF Cross-System Data Server facility (XDS). To start XDS, change this to the XDS member that you want to start.


XDS control statement members are stored in the parameter library allocated to the DDName PARMLIB. A commented set of XDS control statements is located in the CMFXDS01 member of the hilevel.BBPARM library.

This parameter uses the following syntax:

XDS={xx | STOP}

The default is 00.

The default of XDS=00 causes the CX10XGDS API to be available, but does not buffer any SMF records for the CA10XDGY/CX10XDRC APIs to access.

This value may be changed at runtime via the z/OS MODIFY (F) command, such as "F mvspas,XDS=01".

Requirements for sharing cross-system data are as follows:

  • All systems must be in the same sysplex.

  • The z/OS PAS on each system must have XDS active.

  • DC=START must be specified for each z/OS PAS.

  • The CAS on all systems must be in the same XCF group.

To collect XDS data, specify XDS=xx, where xx indicates the suffix of a CMFXDS xx member in the hlq.UBBPARM data set that was created by MainView Customization. You can switch to a different XDS member without stopping the z/OS PAS or XDS by using the MODIFY command.

Example

If you are running the z/OS PAS pointing to the CMFXDS00 member with XDS=00, you can begin using the CMFXDS01 member by issuing the following MODIFY command: F MVSPAS,XDS=01. To stop XDS without stopping the z/OS PAS, issue the following MODIFY command: F MVSPAS,XDS=STOP.



Was this page helpful? Yes No Submitting... Thank you

Comments