Limited supportBMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Ops Infrastructure 7.1.

z/OS PAS started task parameters

The following sections describes each parameter in the z/OS PAS started task procedure:

.id

(Optional) Assigns an arbitrary ID to the PAS started task.

For example, you might enter START MVSPAS.PASA to start a PAS called PASA and START MVSPAS,PASB to start a PAS called PASB. This way, you can control the two PASs independently.

CMDID=symbol

(Optional) Defines a single character that can be used in place of the MODIFY command and procname when a MODIFY command is issued to the PAS.

You can use the CMDID parameter 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: . ( ) * - + > : < = & ^ % / ? # ' @ + _ " |

Note

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 specific environment. Alternatively, operands can be specified as a two-digit hexadecimal representation.

For information about using the MODIFY command, see Controlling-z-OS-PAS-operation.

CPM={xx|00}

(Optional, used for CMF MONITOR and MainView for z/OS only) Specifies the two-character suffix of the CMFCPM xx control statement member in the data set pointed to by the //PARMLIB DD statement.

The member pointed to by the CPM parameter must be named CMFCPMxx, where xx is the suffix defined with CPM. The default is CPM=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 hilevel.UBBPARM data set created by customization.

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

CXEN={Y|N}

(Optional, used for CMF MONITOR only) Controls whether more than one copy of the Extractor can initialize on the same system.

The default is Y (Yes), which allows enqueue and 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.

By specifying CXEN=N for any additional Extractors, more than one CMF MONITOR Extractor can execute on the same system concurrently. CXEN=N prevents the Extractor from writing to SMF data sets, sampling workload data, and sampling enqueue data.

You should not run multiple Extractors because of associated overhead, 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={CPM|IPM| START|STOP}

(Optional, used for CMF MONITOR and MainView for z/OS only) Affects the samplers associated with the PGDDLAY and CFDATA Extractor control statement and the z/OS PAS data collectors; it has the following attributes:

  • START (the default): z/OS PAS data collectors initialize at startup under CPM monitoring mode. When the data collectors are initialized, access to CMF MONITOR and MainView for z/OS is provided. The CMF samplers associated with the PGDDLAY and CFDATA Extractor control statements are enabled for sampling.

  • STOP: Data collectors do not initialize when the z/OS PAS initializes. You cannot access CMF MONITOR or MainView for z/OS. The CMF MONITOR PGDDLAY and CFDATA Extractor control statements do not sample data because both gather information from the z/OS PAS data collectors.

  • CPM: z/OS PAS data collectors initialize and accept data from the Extractor in CPM mode at startup. Specifying DC=CPM is the same as DC=START.

  • IPM: z/OS PAS data collectors initialize and accept data coming from the Extractor in IPM mode at startup.

If you specify DC=IPM, you must also specify the parameter IPM=xx, where xx is the suffix of the CMFIPMxx control statement member that is pointed to by the //PARMLIB DD statement.

The DC parameter can also be changed by using a MODIFY command, so the data collectors can be started or stopped or the monitoring modes switched without requiring the z/OS PAS (and Extractor) to be stopped and then started. You can specify an additional operand with the DC parameter when the MODIFY command is issued:

STATUS (the status of each data collector is displayed in the job log)

Warning

DC=STATUS should not be specified at z/OS PAS initialization because the data collectors do not initialize. It should be used only when the PAS is running.

For more information about how to use the MODIFY command, see Controlling-z-OS-PAS-operation.

EM={xx|00}

(Used for MainView for z/OS only) Specifies the two-character suffix of the PWSCPM xx control statement member that you want the MainView for z/OS Exception Monitor to use.

IPM={xx|00}

(Optional, used for CMF MONITOR and MainView for z/OS only) Specifies the two-character suffix of the CMFIPM xx control statement member in the data set pointed to by the //PARMLIB DD statement.

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.

The member pointed to by the IPM parameter must be named CMFIPMxx, where xx is the suffix defined with IPM. The default is IPM=00.

The control statement member contains the Extractor REPORT and sampler control statements, which are detailed in CMF-MONITOR-User-Guide-and-Reference. This member controls the operation of the IPM mode samplers and defines the resources that the Extractor monitors.

IPM mode samplers execute either when a MODIFY command is issued or when the IPM parameter is used. Sample control statement members are in the hilevel.UBBPARM data set created by customization.

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

OMVSLIM=nnnn

(Optional, used for version 5.8.00 and later of CMF MONITOR or version 3.0.00 or later of MainView for z/OS only) 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.

The default is OMVSLIM=1000.

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

procname

Specifies the name of the startup procedure for the PAS (for example, MVSPAS).

REUSASID=YES

(Optional) For z/OS 1.9 and higher, assigns the address space to the reusable address space pool.

See the START command in the IBM z/OS MVS System Commands for details on the usage of this parameter.

SSID=ssid

Specifies the subsystem ID of the CAS to which the z/OS PAS should connect.

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.

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

SYSID=sysid

Specifies the SMF system ID for your system.

USEZIIP=(Y|N)

(Optional, used for CMF MONITOR and MainView for z/OS only) Specifies if eligible CPU processing should be offloaded to zIIPs if zIIPs are online.

The default is Y (Yes).

The USEZIIP parameter can also be specified using the MODIFY command, which gives you control over whether zIIP-eligible processing should be offloaded from standard CPs to zIIPs.

XDM={Y|N}

(Optional) Specifies whether or not the z/OS PAS should execute in extended diagnostic mode (XDM), which produces additional messages and suspends some PAS error recovery processing.

The default is N (No).

Warning

Only specify XDM=Y as instructed by BMC Customer Support. The XDM=Y parameter disables certain error recovery mechanisms that could severely impact your system.

XDS={xx|STOP}

(Optional, used for CMF MONITOR only) Controls the collection of data by the cross-system data server (XDS).

To share cross-system data, all the 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, and the CAS on all systems must be in the same CASDEF XCF group.

For SDSF to use XDS data, the BBLINK data set needs to be either in the link list or in the TSO logon procedure STEPLIB.

To collect XDS data, specify XDS= xx, where xx indicates the suffix of a CMFXDS xx member of hilevel.UBBPARM that was created by customization. You can switch to a different XDS member without stopping either the z/OS PAS or XDS by using the MODIFY command. For example, if you are running the z/OS PAS that points to the CMFXDS00 member with XDS=00, you can begin using the CMFXDS01 member by issuing the MODIFY command F MVSPAS,XDS=01. You can also stop XDS without stopping the z/OS PAS by issuing the MODIFY command F MVSPAS,XDS=STOP.

The parameters for the CMFXDSxx members are TYPE, RECORDS, and SIZE. Each of these parameters may be specified only once in a particular XDS member. If a line begins with an asterisk (*), that line is ignored. Data in columns 73-80 is also ignored.

  • TYPE defines which SMF record types are included in the XDS SMF record buffer for the CX10XDQY and CX10XDRC APIs. Specify one of the following values:

    • Specify TYPE CMF to use output records from CMF itself. Use this parameter to buffer all type 70-78 records, as well as all CMF user record types. This option is the default value if the TYPE parameter is not specified.

    • Specify TYPE SMF to use SMF IEFU83, IEFU84, and IEFU85 dynamic exits. Use this parameter to buffer all record types except those written to CMF Extractor output data sets. If the CMF Extractor is writing to SMF, TYPE SMF works exactly the same as TYPE ALL.

    • Specify TYPE ALL to use both SMF-provided and CMF-provided records.

    • Specify TYPE NONE to allow API calls and CX10XDGS requests for type 79 data from this system without buffering records on this system.
  • RECORDS defines which SMF record types and subtypes are included in the XDS buffer. This parameter must specify a subset of the records that are specified for collection by the TYPE parameter. Records that are specified with this parameter are available for CX10XDQY (XDS record query) and CX10XDRC (XDS record retrieval) API calls.

In addition, cross-system snapshots of type 79 data are available from the CX10XDGS (XDS data-gathering service) API call.

Specify the records that you want to include in the buffer by listing those types in a list (which may continue on multiple lines) that follows the RECORDS parameter. For example, if you want to buffer type 70 and 72 records only, you specify RECORDS 70,72. You can specify subtypes by placing a hyphen (-) after a type, followed immediately by the subtype. For example, to buffer only subtype 3 of type 72 records, specify RECORDS 72-3.

Ranges of types and subtypes can be specified either by using a colon to separate the start and end of a range or by using an X character to indicate all digits in a range. For example, to buffer record types 70 through 79, you can specify either RECORDS 70:79 or RECORDS 7X.

If you do not want to buffer any records, specify RECORDS NONE. If you want to buffer all record types included in the TYPE parameter, specify RECORDS ALL. This option is the default if you do not include a RECORDS parameter.

  • SIZE defines how much SMF data should be buffered before records are lost because of buffer wraparound.

Specify a size in the format of SIZE nnnu, where nnn is a one- to nine-digit number and u is one of the following values:


    • blank (bytes)
    • K (kilobytes) (2**10 bytes)
    • M (megabytes) (2**20 bytes)
    • G (gigabytes) (2**30 bytes)

For example, for a buffer size of 3 megabytes, specify SIZE 3M. If you do not specify the SIZE parameter, the default buffer size is 32M.

You can also specify the word PURGE with this parameter to indicate that the existing buffer should be discarded at the time of a MODIFY command, rather than when the new buffer fills up. For example, to change a buffer size from 3 megabytes to 5 megabytes and immediately discard the 3 megabyte buffer, specify SIZE 5M,PURGE on the member referred to by the MODIFY command.

Related topic

Starting-the-z-OS-PAS

 

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