## zowe › mat-pma-util › scope › exl-pgm

Exclude a program from the PMA scope of work.

#### Usage

zowe mat-pma-util scope exl-pgm <pgmname> [options]

#### Positional Arguments

- `pgmname` (string)

  - Specifies the name of the program that you want to add to the list of exclusions from the PMA scope (e.g. TESTPMA8).

#### Options

- `--description` | `--dc` (string)

  - Specifies the description of the program that you want to exclude from the PMA scope.

#### PMA Connection Options

- `--job_acct` | `--ja` (string)

  - Specifies z/OS TSO/E accounting information. Values: numeric characters (0-9)

- `--job_class` | `--jc` (string)

  - Your z/OS class information. Values: alphanumeric characters (A-Z, 0-9)

- `--job_mclass` | `--jmc` (string)

  - Specifies the MSGCLASS parameter value and assigns the job log to the specified output class. The specified MSGCLASS value is used in all JCLs that PMA runs while you execute the commands. If you do not provide the job_mclass parameter, the default MSGCLASS value is used. Values: alphanumeric characters (A-Z, 0-9)

    Default value: A

- `--job_load` | `--jl` (string)

  - Specifies the PMA loadlib data set name that you defined during the PMA customization (&HLQ.CEETLOAD)

- `--job_pmahlq` | `--jph` (string)

  - Specifies your PMA HLQ to access the KSDSALT, KSDSJOB, and KSDSEXC VSAM files that ensure the collection of the necessary data

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) profile to load for this command execution.

- `--pma-profile` | `--pma-p` (string)

  - The name of a (pma) profile to load for this command execution.

- `--base-profile` | `--base-p` (string)

  - The name of a (base) profile to load for this command execution.

#### Base Connection Options

- `--host` | `-H` (string)

  - Host name of service on the mainframe.

- `--port` | `-P` (number)

  - Port number of service on the mainframe.

- `--user` | `-u` (string)

  - User name to authenticate to service on the mainframe.

- `--password` | `--pass` | `--pw` (string)

  - Password to authenticate to service on the mainframe.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--token-type` | `--tt` (string)

  - The type of token to get and use for the API. Omit this option to use the default token type, which is provided by 'zowe auth login'.

- `--token-value` | `--tv` (string)

  - The value of the token to pass to the API.

- `--cert-file` (local file path)

  - The file path to a certificate file to use for authentication.

    Note: The CLI does not support certificate files that require a password. For more information, search Troubleshooting PEM Certificates in Zowe Docs.

- `--cert-key-file` (local file path)

  - The file path to a certificate key file to use for authentication

#### Examples

- Exclude the TESTPMA8 program from the PMA scope:

  - `zowe mat-pma-util scope exl-pgm TESTPMA8`

- Exclude the TESTPMA8 program from the PMA scope and add a description to the excluded program:

  - `zowe mat-pma-util scope exl-pgm TESTPMA8 --dc "EXCLUDE FROM THE CURRENT SCOPE"`

- Exclude the TESTPMA8 program from the PMA scope and add a description to the excluded program using specific PMA profile details:

  - `zowe mat-pma-util scope exl-pgm TESTPMA8 --dc "EXCLUDE FROM THE CURRENT SCOPE" --ja 123456789 --jc A --jmc A --jl HLQ.CEETLOAD --jph PMAHLQ`