## zowe › mat-pma-util › scope › inc-job

Include a job in the PMA scope of work.

#### Usage

zowe mat-pma-util scope inc-job <jobname> [options]

#### Positional Arguments

- `jobname` (string)

  - Specifies the name of the job that you want to add to the list of inclusions in the PMA scope (e.g. TESTPMA8).

#### Options

- `--stepname` | `--st` (string)

  - Specifies the name of the job step that you want to include in the PMA scope.

- `--procstep` | `--ps` (string)

  - Specifies the procname of the job that you want to include in the PMA scope.

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

  - Specifies the description of the job that you want to include in 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

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

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

#### Examples

- Include the TESTPMA8 job in the PMA scope:

  - `zowe mat-pma-util scope inc-job TESTPMA8`

- Include the specific procname and step name of the TESTPMA8 job in the PMA scope and add a description to the included job:

  - `zowe mat-pma-util scope inc-job TESTPMA8 --ps TESTCALL --st TESTDO --dc "INCLUDE IN THE CURRENT SCOPE"`

- Include the specific procname and step name of the TESTPMA8 job in the PMA scope and add a description to the included job using specific PMA profile details:

  - `zowe mat-pma-util scope inc-job TESTPMA8 --ps TESTCALL --st TESTDO --dc "INCLUDE IN THE CURRENT SCOPE" --ja 123456789 --jc A --jmc A --jl HLQ.CEETLOAD --jph PMAHLQ`