## zowe

Welcome to Zowe CLI!

Zowe CLI is a command line interface (CLI) that provides a simple and streamlined way to interact with IBM z/OS.

For additional Zowe CLI documentation, visit https://docs.zowe.org

For Zowe CLI support, visit https://www.zowe.org

#### Options

- `--version` | `-V` (boolean)

  - Display the current version of Zowe CLI

- `--available-commands` | `--ac` (boolean)

  - Displays a list of available commands

#### Global Options

- `--response-format-json` | `--rfj` (boolean)

  - Produce JSON formatted data from a command

- `--help` | `-h` (boolean)

  - Display help text

- `--help-web` | `--hw` (boolean)

  - Display HTML help in browser

#### Table of Contents

- auth
  - login | li
    - apiml
  - logout | lo
    - apiml
- ca7 | 7
  - agent | agt
    - agentDetails | agd
    - agentDetails_1 | agd1
    - agentLogList | agll
    - agentLogList_1 | agll1
    - agentLogs | pagl
    - agentLogs_1 | pagl1
    - agentParms | agp
    - agentParms_1 | agp1
    - listAgents | lag
    - listAgents_1 | lag1
    - pingAgent | pag
    - pingAgent_1 | pag1
    - putAgentParms | uagp
    - putAgentParms_1 | uagp1
    - stopAgent | sag
    - stopAgent_1 | sag1
    - stopStartAgent | ssag
    - stopStartAgent_1 | ssag1
  - agent-cred | agtcred
    - deleteAgentCredentials | dag
    - deleteAgentCredentials_1 | dag1
    - getAgentCredentialsStatus | gags
    - getAgentCredentialsStatus_1 | gags1
    - postAgentCredentials | pag
    - postAgentCredentials_1 | pag1
    - putAgentCredentials | uag
    - putAgentCredentials_1 | uag1
  - batch | batch
    - batch | bat
  - CA7-instances | inst
    - delete-instance | di
    - get-instance | gi
    - post-instance | pi
    - post-list-instance | pli
    - put-instance | ui
  - commands | cmds
    - addrq | ar
    - addrq_1 | ar1
    - arfp | arp
    - arfp_1 | arp1
    - cancel | cal
    - cancel_1 | cal1
    - demand | ded
    - demand_1 | ded1
    - demandh | deh
    - demandh_1 | deh1
    - hold | hod
    - hold_1 | hod1
    - jclovrd | jcd
    - jclovrd_1 | jcd1
    - post | po
    - post_1 | po1
    - prscf | prf
    - prscf_1 | prf1
    - prsqa | pra
    - prsqa_1 | pra1
    - prsqd | prd
    - prsqd_1 | prd1
    - release | rel
    - release_1 | rel1
    - requeue | req
    - requeue_1 | req1
    - resolve | res
    - resolve_1 | res1
    - restart | ret
    - restart_1 | ret1
    - run | run
    - run_1 | run1
    - runh | runh
    - runh_1 | runh1
    - submit | sub
    - submit_1 | sub1
    - subtm | subtm
    - subtm_1 | subtm1
    - verify | ver
    - verify_1 | ver1
  - dataset | ds
    - delete-dataset | dds
    - delete-dataset_1 | dds1
    - delete-trigger | dtr
    - delete-trigger_1 | dtr1
    - post-dataset | pds
    - post-dataset_1 | pds1
    - post-trigger | ptr
    - post-trigger_1 | ptr1
    - rename-dataset | rds
    - rename-dataset_1 | rds1
    - update-dataset | uds
    - update-dataset_1 | uds1
    - update-trigger | utr
    - update-trigger_1 | utr1
  - job-definition | jd
    - delete-address-space-resource | dasr
    - delete-address-space-resource_1 | dasr1
    - delete-corequisite-resource | dcr
    - delete-corequisite-resource_1 | dcr1
    - delete-exclusive-resource | der
    - delete-exclusive-resource_1 | der1
    - delete-job | dj
    - delete-job_1 | dj1
    - delete-job-schedule | djs
    - delete-job-schedule_1 | djs1
    - delete-requirement-predecessor | drp
    - delete-requirement-predecessor_1 | drp1
    - delete-resource-count-resource | drcr
    - delete-resource-count-resource_1 | drcr1
    - delete-shared-resource | dsr
    - delete-shared-resource_1 | dsr1
    - delete-trigger-successor | dts
    - delete-trigger-successor_1 | dts1
    - delete-variable-resource | dvr
    - delete-variable-resource_1 | dvr1
    - list-job | lj
    - list-job_1 | lj1
    - list-job-resources | ljr
    - list-job-resources_1 | ljr1
    - list-job-schedules | ljs
    - list-job-schedules_1 | ljs1
    - list-requirement-predecessor | lrp
    - list-requirement-predecessor_1 | lrp1
    - list-requirement-successor | lrs
    - list-requirement-successor_1 | lrs1
    - list-trigger-successor | lts
    - list-trigger-successor_1 | lts1
    - post-address-space-resource | pasr
    - post-address-space-resource_1 | pasr1
    - post-corequisite-resource | pcr
    - post-corequisite-resource_1 | pcr1
    - post-exclusive-resource | per
    - post-exclusive-resource_1 | per1
    - post-job | pj
    - post-job_1 | pj1
    - post-job-schedule | pjs
    - post-job-schedule_1 | pjs1
    - post-requirement-predecessor | prp
    - post-requirement-predecessor_1 | prp1
    - post-resource-count-resource | prcr
    - post-resource-count-resource_1 | prcr1
    - post-shared-resource | psr
    - post-shared-resource_1 | psr1
    - post-trigger-successor | pts
    - post-trigger-successor_1 | pts1
    - post-variable-resource | pvr
    - post-variable-resource_1 | pvr1
    - prose-information | pi
    - prose-information_1 | pi1
    - step-DD | sd
    - step-DD_1 | sd1
    - trigger-predecesssor | tp
    - trigger-predecesssor_1 | tp1
    - update-address-space-resource | uasr
    - update-address-space-resource_1 | uasr1
    - update-corequisite-resource | ucr
    - update-corequisite-resource_1 | ucr1
    - update-exclusive-resource | uer
    - update-exclusive-resource_1 | uer1
    - update-job | uj
    - update-job_1 | uj1
    - update-job-schedule | ujs
    - update-job-schedule_1 | ujs1
    - update-requirement-predecessor | urp
    - update-requirement-predecessor_1 | urp1
    - update-resource-count-resource | urcr
    - update-resource-count-resource_1 | urcr1
    - update-shared-resource | usr
    - update-shared-resource_1 | usr1
    - update-trigger-successor | uts
    - update-trigger-successor_1 | uts1
  - job-history | jh
    - prior-run-queue | prq
    - prior-run-queue_1 | prq1
  - job-instance | ji
    - active-resource | ar
    - active-resource_1 | ar1
    - jcl | jcl
    - jcl_1 | jcl1
    - list | list
    - list_1 | list1
    - list-custom | lc
    - list-custom_1 | lc1
    - list-waiting-resource | lwr
    - list-waiting-resource_1 | lwr1
    - requirements | req
    - requirements_1 | req1
    - update-jcl | ujcl
    - update-jcl_1 | ujcl1
  - resources | res
    - delete-resource-count | drc
    - delete-resource-count_1 | drc1
    - get-resource-count | grc
    - get-resource-count_1 | grc1
    - post-resource-count | prc
    - post-resource-count_1 | prc1
    - update-resource-count | urc
    - update-resource-count_1 | urc1
  - transaction | trans
    - key | key
  - version | version
    - version | ver
- cics
  - add-to-list | atl
    - csdGroup | csdg
  - define | def
    - bundle | bund
    - program | prog
    - transaction | tran
    - urimap-client | uc
    - urimap-pipeline | up
    - urimap-server | us
    - webservice | web
  - delete | del
    - program | prog
    - transaction | tran
    - urimap
    - webservice | web
  - disable
    - urimap
  - discard | dis
    - program | prog
    - transaction | tran
    - urimap
  - enable | en
    - urimap
  - get
    - resource | res
  - install | ins
    - program | prog
    - transaction | tran
    - urimap
  - refresh | ref
    - program | prog
  - remove-from-list | rfl
    - csdGroup | csdg
- config
  - auto-init
  - convert-profiles | convert
  - edit
  - import
  - init
  - list | ls
  - profiles
  - report-env | re
  - schema
  - secure
  - set
  - update-schemas | us
- daemon
  - disable
  - enable
  - restart
- db2
  - call
    - procedure | proc | sp
  - execute
    - sql
  - export
    - table
- dbm-db2 | dbm
  - check
    - ddl
  - compare
    - ddl
  - deploy
    - ddl
  - execute
    - compare-script
    - migration-script
    - script
  - generate
    - ddl
  - prepare
    - migration
- endevor
  - add
    - element | elem | ele
  - approve | aprv
    - package | pkg
  - backin
    - package | pkg
  - backout
    - package | pkg
  - cast
    - package | pkg
  - check
    - instance
  - commit
    - package | pkg
  - confirm | conf
    - resolution | res
  - create
    - package | pkg
  - delete | del
    - element | elem | ele
    - package | pkg
  - deny
    - package | pkg
  - execute
    - package | pkg
  - generate | gen
    - element | elem | ele
  - initialize | init
    - workspace | wsp
  - list
    - code-page-config | codepages | cdpg
    - defaults
    - dialog
    - elements | elem | ele
    - environments | environment | env
    - features
    - instances | instance | inst | i
    - packages | package | pkg | p
    - processor-groups | processor-group | pgrp
    - processor-symbols | processor-symbol | psym
    - stages | stage | stg
    - subsystems | subsystem | subsys | sbs
    - symbols
    - systems | system | sys | s
    - tasks
    - type-sequence | typeseq
    - types | type | t
  - merge | mrg
    - element | ele
  - move | mv
    - element | elem | ele
  - print | p
    - components | comp
    - element | elem | ele
    - member | mem
  - queryacm
    - components | comp
  - reset
    - package | pkg
  - retrieve | ret
    - element | elem | ele
    - result | res
  - signin | si
    - element | elem | ele
  - submit
    - package | pkg
    - scl
  - synchronize | sync
    - workspace | wsp
  - transfer | tr
    - element | elem | ele
  - unsynchronize | unsync
    - workspace | wsp
  - update
    - element | elem | ele
    - package | pkg
  - view
    - element | elem | ele
    - pkgscl | packagescl
- file-master-plus | fmp
  - copy | c
    - data-set | ds
  - create | cre
    - large-format-sequential | large
    - like-model | model | lm
    - partitioned-data-set | pds
    - partitioned-data-set-extended | pdse
    - physical-sequential | ps
    - vsam-esds | esds
    - vsam-ksds | ksds
    - vsam-lds | lds
    - vsam-rrds | rrds
    - vsam-vrrds | vrrds
  - delete | del
    - data-set | ds
  - populate | pop
    - data-set | ds
  - rename | ren
    - data-set | ds
- idms
  - issue | iss
    - dcmt-display | dd
    - dcmt-help | dh
    - dcmt-quiesce | dq
    - dcmt-shutdown | shutdown
    - dcmt-statistics | ds
    - dcmt-test | dt
    - dcmt-vary | dv
    - dcuf-help | dfh
    - dcuf-show | dfs
  - list | ls
    - datasources | ds
    - log
    - systems | sys
    - transactions | ts
    - user-tasks | ut
- jclcheck | jck
  - check | ck
    - data-set | ds
    - local-file | lf
- mat | mat
  - monitor
    - codeview
      - callerid | cil
      - csect | cs
      - histogram | hsg
      - module | mod
    - db2
      - db2view | db2v
      - sqlstmt | sql
    - delayview
      - address | ad
      - delay | de
    - history | hs
    - idms | idms
      - dml | dml
      - module | mod
      - task | ts
    - imsview | ims
      - dbdname | dbd
      - imsview | imsv
      - psbname | psb
      - region | reg
      - ssa | ssa
      - statement | stat
    - overview | ov
    - tranview | tr
      - all | all
      - callerid | cid
      - callstack | csk
      - csect | csd
      - delay | dl
      - module | mod
      - stat | cis
  - profile
    - create | cr
    - invoke | ivk
    - list | lip
- mat-pma-util | pma
  - get | gt
    - alert | at
    - alert-by-job | abyj
    - perf | pf
  - scope | scp
    - del-job | delj
    - del-pgm | delp
    - exl-pgm | exlp
    - get-listj | getlj
    - get-listp | getlp
    - inc-job | incj
- mq
  - run
    - mqsc
- omspool | esf
  - issue | is
    - command | cmd
- omview | caview | cv
  - download | dl
    - report | r
  - export | exp
    - report | r
  - get
    - user
      - settings
  - list | ls
    - export-rules | rules
    - report | repo
      - index-names | indexes
      - index-values
      - logical-views | views
    - reports
    - repositories | repos
  - search | find
    - index
      - names
      - reports
      - values
  - set
    - user
      - distribution
      - mode
- ops
  - create
    - event
  - disable
    - rule
  - enable
    - rule
  - execute
    - command
    - rexx
  - show
    - logname
    - resource
    - rule
    - ruleset
    - status
    - subsystem
    - table
  - start
    - resource
  - stop
    - resource
- plugins
  - install
  - list
  - show-first-steps | fs
  - uninstall
  - update
  - validate
- provisioning | pv
  - delete | del
    - instance | i
  - list | ls
    - catalog-templates | ct
    - instance-info | ii
    - instance-variables | iv
    - registry-instances | ri
    - template-info | ti
  - perform | perf
    - action | act
  - provision | prov
    - template | tem
- sysview | sv
  - capture | cap
  - capture-immediate | cap-imm
  - check
    - status
  - display | dsp
  - execute | exe
- zos-console | console
  - collect
    - sync-responses | sr
  - issue
    - command | cmd
- zos-files | files
  - compare | cmp
    - data-set | ds
    - local-file-data-set | lf-ds
    - local-file-spool-dd | lf-sdd
    - local-file-uss-file | lf-uss
    - spool-dd | sdd
    - uss-files | uss | uf
  - copy | cp
    - data-set | ds
    - data-set-cross-lpar | dsclp
  - create | cre
    - data-set | ds
    - data-set-binary | bin
    - data-set-c | dsc
    - data-set-classic | classic
    - data-set-partitioned | pds
    - data-set-sequential | ps
    - data-set-vsam | vsam
    - uss-directory | dir
    - uss-file | file
    - zos-file-system | zfs
  - delete | del
    - data-set | ds
    - data-set-vsam | vsam
    - migrated-data-set | mds
    - uss-file | uf | uss
    - zos-file-system | zfs
  - download | dl
    - all-members | am
    - all-members-matching | amm | all-members-matching
    - data-set | ds
    - data-sets-matching | dsm | data-set-matching
    - uss-directory | uss-dir
    - uss-file | uf | uss
  - edit | ed
    - data-set | ds
    - uss-file | uss | uf
  - invoke | call
    - ams-file | af
    - ams-statements | as
  - list | ls
    - all-members | am
    - data-set | ds
    - file-system | fs
    - uss-files | uf | uss
  - migrate | hmigr | hMigrate
    - data-set | ds
  - mount
    - file-system | fs
  - recall | hrec | hRecall
    - data-set | ds
  - rename
    - data-set | ds
    - data-set-member | dsm
  - search
    - data-sets | ds
  - unmount | umount
    - file-system | fs
  - upload | ul
    - dir-to-pds | dtp
    - dir-to-uss | dtu
    - file-to-data-set | ftds
    - file-to-uss | ftu
    - stdin-to-data-set | stds
  - view | vw
    - data-set | ds
    - uss-file | uf
- zos-ftp | zftp
  - allocate | alloc
    - data-set | ds
  - delete | del
    - data-set | ds
    - job | j
    - uss-file | uss | uf
  - download | dl
    - all-spool-by-jobid | asbj
    - data-set | ds
    - uss-file | uss | uf
  - list | ls
    - data-set | ds
    - data-set-members | members
    - jobs | j | js
    - spool-files-by-jobid | sfbj
    - uss-files | uss | uf
  - make | mk
    - uss-directory | dir
  - rename | mv
    - data-set | ds
    - uss-file | uss | uf
  - submit | sub
    - data-set | ds
    - local-file | lf
    - stdin | si | in
  - upload | ul
    - file-to-data-set | ftds
    - file-to-uss-file | ftuf | ftu
    - stdin-to-data-set | stds
    - stdin-to-uss-file | stuf | stu
  - view | vw
    - all-spool-by-jobid | asbj
    - data-set | ds
    - job-status-by-jobid | jsbj
    - spool-file-by-id | sfbi
    - uss-file | uss | uf
- zos-jobs | jobs
  - cancel | can
    - job
  - delete | del
    - job
    - old-jobs | oj
  - download | dl
    - output | o
  - list | ls
    - jobs | js
    - spool-files-by-jobid | sfbj
  - modify | mod
    - job
  - search | sea
    - job
  - submit | sub
    - data-set | ds
    - local-file | lf
    - stdin | in
    - uss-file | uf | uss
  - view | vw
    - all-spool-content | asc
    - job-status-by-jobid | jsbj
    - spool-file-by-id | sfbi
- zos-logs | logs
  - list | ls
    - logs
- zos-ssh | ssh | zos-uss | uss
  - issue | iss
    - command | cmd | ssh
- zos-tso | tso
  - issue
    - command | cmd
  - ping
    - address-space | as
  - receive | r
    - app | a
  - send
    - address-space | as
    - app | a
  - start | st
    - address-space | as
    - app | a
  - stop | sp
    - address-space | as
- zos-workflows | wf
  - archive
    - active-workflow | aw
  - create | cre
    - workflow-from-data-set | wfds
    - workflow-from-local-file | wflf
    - workflow-from-uss-file | wfuf
  - delete | del
    - active-workflow | aw
    - archived-workflow | arw
  - list | ls
    - active-workflow-details | awd
    - active-workflows | aw
    - archived-workflows | arw
    - definition-file-details | dfd
  - start | sta
    - workflow-full | wf
    - workflow-step | ws
- zosmf
  - check
    - status
  - list
    - systems

## zowe › auth

Connect to Zowe API Mediation Layer authentication service and obtain a token, or disconnect from the authentication service and revoke the token.

The token provides authentication to services that support the API ML SSO (Single Sign-On) capability. When you log in, the token is stored in your default base profile until it expires. Base profiles store connection information shared by multiple services (e.g., z/OSMF), and are used if you do not supply connection information in a service profile. To take advantage of the API ML SSO capability, you should omit username and password in service profiles so that the token in the base profile is used.

## zowe › auth › login

Log in to an authentication service.

### zowe › auth › login › apiml

Log in to Zowe API Mediation Layer authentication service and obtain or update a token.

The token provides authentication to services that support the API ML SSO (Single Sign-On) capability. When you log in, the token is stored in your default base profile until it expires. Base profiles store connection information shared by multiple services (e.g., z/OSMF), and are used if you do not supply connection information in a service profile. To take advantage of the API ML SSO capability, you should omit username and password in service profiles so that the token in the base profile is used.

#### Usage

zowe auth login apiml [options]

#### Options

- `--show-token` | `--st` (boolean)

  - Show the token when login is successful. If specified, does not save the token to a profile.

#### 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

- `--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

#### Profile Options

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

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

#### Examples

- Log in to an API ML instance to obtain or update the token stored in your base profile:

  - `zowe auth login apiml`

- Log in to an API ML instance to obtain a token without storing it in a profile:

  - `zowe auth login apiml --show-token`

## zowe › auth › logout

Log out of an authentication service.

### zowe › auth › logout › apiml

Log out of the Zowe API Mediation Layer authentication service and revoke the token so it can no longer authenticate. Also remove the token from the default base profile, if it is stored on disk.

#### Usage

zowe auth logout apiml [options]

#### Base Connection Options

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

  - Host name of service on the mainframe.

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

  - Port number of service on the mainframe.

- `--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'.

    Allowed values: apimlAuthenticationToken.*, jwtToken, LtpaToken2

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

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

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

  - Reject self-signed certificates.

    Default value: true

#### Profile Options

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

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

#### Examples

- Log out of an API ML instance to revoke the token that was in use and remove it from your base profile:

  - `zowe auth logout apiml`

- Log out of an API ML instance to revoke a token that was not stored in a profile:

  - `zowe auth logout apiml --token-value <token>`

## zowe › ca7

Welcome to the CA 7 Zowe CLI!

## zowe › ca7 › agent

All the available commands listed in the Agent management section.

### zowe › ca7 › agent › agentDetails

Return additional details about an Agent.

#### Usage

zowe ca7 agent agentDetails [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.

    Default: Linux

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get Agent details of AGENTTEST for INSTANCE1:

  - `zowe ca7 agent agentDetails --agname AGENTTEST --ca7Id INSTANCE1`

### zowe › ca7 › agent › agentDetails › 1

Return additional details about an Agent.

#### Usage

zowe ca7 agent agentDetails_1 [options]

#### Required Options

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.

    Default: Linux

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get Agent details for AGENTTEST:

  - `zowe ca7 agent agentDetails_1 --agname AGENTTEST`

### zowe › ca7 › agent › agentLogList

Get a list of log files from the Agent.

#### Usage

zowe ca7 agent agentLogList [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.

    Default: Linux

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get list of log files of AGENTTEST for INSTANCE1:

  - `zowe ca7 agent agentLogList --agname AGENTTEST --ca7Id INSTANCE1`

### zowe › ca7 › agent › agentLogList › 1

Get a list of log files from the Agent.

#### Usage

zowe ca7 agent agentLogList_1 [options]

#### Required Options

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.

    Default: Linux

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get list of log files for AGENTTEST:

  - `zowe ca7 agent agentLogList_1 --agname AGENTTEST`

### zowe › ca7 › agent › agentLogs

Retrieve a Zip file containing files from the Agent's log directory. If a list of file names is supplied, only log files matching the specified name(s) will be included.
If a list of file names is not supplied, all of the logs will be included.
Note: WARNING: Depending on the size of the Agent's log files and which files are retrieved, this operation may take considerable time to complete.

#### Usage

zowe ca7 agent agentLogs [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.
    WindowsLinuxUnixetc.Default: Linux

- `--logmaxsource` | `--log` (string)

  - Specifies the maximum size of all source log files to be retrieved.

    Limits: 1 to 10 numeric characters in the range 1-2147483647
    Default: 524288000

- `--logmaxzip` (string)

  - Specifies the maximum size of of the target Zip file to be retrieved.

    Limits: 1 to 10 numeric characters in the range 1-2147483647
    Default: 262144000

- `--filenames` (array)

  - Log file names. Wildcards are not allowed.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get Agent logs of AGENTTEST for INSTANCE1:

  - `zowe ca7 agent agentLogs --agname AGENTTEST --ca7Id INSTANCE1`

### zowe › ca7 › agent › agentLogs › 1

Retrieve a Zip file containing files from the Agent's log directory. If a list of file names is supplied, only log files matching the specified name(s) will be included.
If a list of file names is not supplied, all of the logs will be included.
Note: WARNING: Depending on the size of the Agent's log files and which files are retrieved, this operation may take considerable time to complete.

#### Usage

zowe ca7 agent agentLogs_1 [options]

#### Required Options

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.
    WindowsLinuxUnixetc.Default: Linux

- `--logmaxsource` | `--log` (string)

  - Specifies the maximum size of all source log files to be retrieved.

    Limits: 1 to 10 numeric characters in the range 1-2147483647
    Default: 524288000

- `--logmaxzip` (string)

  - Specifies the maximum size of of the target Zip file to be retrieved.

    Limits: 1 to 10 numeric characters in the range 1-2147483647
    Default: 262144000

- `--filenames` (array)

  - Log file names. Wildcards are not allowed.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get Agent logs of AGENTTEST:

  - `zowe ca7 agent agentLogs_1 --agname AGENTTEST`

### zowe › ca7 › agent › agentParms

Retrieve a text file containing the Agent's parameters (agentparm.txt).

#### Usage

zowe ca7 agent agentParms [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.
    WindowsLinuxUnixetc.Default: Linux

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get Agent parameters of AGENTTEST for INSTANCE1:

  - `zowe ca7 agent agentParms --agname AGENTTEST --ca7Id INSTANCE1`

### zowe › ca7 › agent › agentParms › 1

Retrieve a text file containing the Agent's parameters (agentparm.txt).

#### Usage

zowe ca7 agent agentParms_1 [options]

#### Required Options

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.
    WindowsLinuxUnixetc.Default: Linux

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get Agent parameters for AGENTTEST:

  - `zowe ca7 agent agentParms_1 --agname AGENTTEST`

### zowe › ca7 › agent › listAgents

List information about the agents defined to CA 7

#### Usage

zowe ca7 agent listAgents [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- List agents for INSTANCE1:

  - `zowe ca7 agent listAgents --ca7Id INSTANCE1`

### zowe › ca7 › agent › listAgents › 1

List information about the agents defined to CA 7

#### Usage

zowe ca7 agent listAgents_1 [options]

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Lists Agent for DEFAULT_INSTANCE:

  - `zowe ca7 agent listAgents_1`

### zowe › ca7 › agent › pingAgent

Ping an Agent. This operation will ping the specified Agent to see if it is up and operational.

#### Usage

zowe ca7 agent pingAgent [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Ping Agent AGENTTEST for INSTANCE1:

  - `zowe ca7 agent pingAgent --agname AGENTTEST --ca7Id INSTANCE1`

### zowe › ca7 › agent › pingAgent › 1

Ping an Agent. This operation will ping the specified Agent to see if it is up and operational.

#### Usage

zowe ca7 agent pingAgent_1 [options]

#### Required Options

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Ping Agent AGENTTEST:

  - `zowe ca7 agent pingAgent_1 --agname AGENTTEST`

### zowe › ca7 › agent › putAgentParms

Update the Agent's parameters (agentparm.txt).
Note: WARNING: This operation will cause the Agent to be stopped and started with the new parameters.
If the Agent cannot be started with the new parameters, the previous parameters will be restored and the Agent will be started.

#### Usage

zowe ca7 agent putAgentParms [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

- `--agent-parm-text` | `--apt` (string)

  - The text data containing the new Agent parms (agentparm.txt)

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.

    Default: Linux

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Update Agent parameters of AGENTTEST for INSTANCE1:

  - `zowe ca7 agent putAgentParms --agname AGENTTEST --ca7Id INSTANCE1`

### zowe › ca7 › agent › putAgentParms › 1

Update the Agent's parameters (agentparm.txt).
Note: WARNING: This operation will cause the Agent to be stopped and started with the new parameters.
If the Agent cannot be started with the new parameters, the previous parameters will be restored and the Agent will be started.

#### Usage

zowe ca7 agent putAgentParms_1 [options]

#### Required Options

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

- `--agent-parm-text` | `--apt` (string)

  - The text data containing the new Agent parms (agentparm.txt)

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.

    Default: Linux

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Update Agent parameters of AGENTTEST:

  - `zowe ca7 agent putAgentParms_1 --agname AGENTTEST`

### zowe › ca7 › agent › stopAgent

Stop an Agent. This operation will stop the specified Agent.

Note: WARNING: If successful, the Agent will be stopped and no longer available to accept work. The Agent must be manually started.

#### Usage

zowe ca7 agent stopAgent [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.
    WindowsLinuxUnixetc.Default: Linux

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Stop Agent AGENTTEST for INSTANCE1:

  - `zowe ca7 agent stopAgent --agname AGENTTEST --ca7Id INSTANCE1`

### zowe › ca7 › agent › stopAgent › 1

Stop an Agent. This operation will stop the specified Agent.

Note: WARNING: If successful, the Agent will be stopped and no longer available to accept work. The Agent must be manually started.

#### Usage

zowe ca7 agent stopAgent_1 [options]

#### Required Options

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.
    WindowsLinuxUnixetc.Default: Linux

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Stop Agent AGENTTEST:

  - `zowe ca7 agent stopAgent_1 --agname AGENTTEST`

### zowe › ca7 › agent › stopStartAgent

Stop-start an Agent. This operation will stop and start the specified Agent.

#### Usage

zowe ca7 agent stopStartAgent [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.
    WindowsLinuxUnixetc.Default: Linux

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Stop-start Agent AGENTTEST for INSTANCE1:

  - `zowe ca7 agent stopStartAgent --agname AGENTTEST --ca7Id INSTANCE1`

### zowe › ca7 › agent › stopStartAgent › 1

Stop-start an Agent. This operation will stop and start the specified Agent.

#### Usage

zowe ca7 agent stopStartAgent_1 [options]

#### Required Options

- `--agent-name` | `--agname` (string)

  - Specifies the name of the Agent for which to retrieve additional details.
    Limits: 1 to 16 alphanumeric characters

#### Options

- `--os` (string)

  - Specifies the operating system of the Agent as known by the Scheduler.
    WindowsLinuxUnixetc.Default: Linux

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Stop-start Agent AGENTTEST:

  - `zowe ca7 agent stopStartAgent_1 --agname AGENTTEST`

## zowe › ca7 › agent-cred

All the available commands listed in the Agent Credential management section.

### zowe › ca7 › agent-cred › deleteAgentCredentials

Delete the Agent credentials associated with a user ID, Agent name, job type and source.

#### Usage

zowe ca7 agent-cred deleteAgentCredentials [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--userid` (string)

  - Specifies a user ID that is passed with a password to an agent for authorization.
    Limits:
    1 to 128 characters. The wildcard characters * and ? are not permitted

#### Options

- `--agent` (string)

  - Specifies the agent that is the target of a job submission and where the user ID and password authorization takes place.

    Limits: 1 to 16 characters. The wildcard characters * and ? are not permitted

    Example: WINAGENT001

- `--jobType` (string)

  - Specifies the job type of the job that requires a user ID and password authorization.

    Limits: 1 to 16 characters. The wildcard characters * and ? are not permitted

    Example: NT_JOB

- `--source` (string)

  - Specifies the source field for a job that requires a user ID and password authorization. This property applies to agent job types which allow CONNECTIONUSER or PROXYUSER C-LANG statements.

    Limits: 1 to 64 characters. The wildcard characters * and ? are not permitted

    Example: example.domain.com

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Delete the Agent credentials associated with a user wlaagent for INSTANCE1:

  - `zowe ca7 agent-cred deleteAgentCredentials --userid wlaagent --ca7Id INSTANCE1`

### zowe › ca7 › agent-cred › deleteAgentCredentials › 1

Delete the Agent credentials associated with a user ID, Agent name, job type and source.

#### Usage

zowe ca7 agent-cred deleteAgentCredentials_1 [options]

#### Options

- `--userid` (string)

  - Specifies a user ID that is passed with a password to an agent for authorization.
    Limits:
    1 to 128 characters. The wildcard characters * and ? are not permitted

- `--agent` (string)

  - Specifies the agent that is the target of a job submission and where the user ID and password authorization takes place.

    Limits: 1 to 16 characters. The wildcard characters * and ? are not permitted

    Example: WINAGENT001

- `--jobType` (string)

  - Specifies the job type of the job that requires a user ID and password authorization.

    Limits: 1 to 16 characters. The wildcard characters * and ? are not permitted

    Example: NT_JOB

- `--source` (string)

  - Specifies the source field for a job that requires a user ID and password authorization. This property applies to agent job types which allow CONNECTIONUSER or PROXYUSER C-LANG statements.

    Limits: 1 to 64 characters. The wildcard characters * and ? are not permitted

    Example: example.domain.com

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Delete the Agent credentials associated with a user wlaagent:

  - `zowe ca7 agent-cred deleteAgentCredentials_1 --userid wlaagent`

### zowe › ca7 › agent-cred › getAgentCredentialsStatus

Check for the presence of Agent credentials associated with the specified user ID, Agent name, job type and source.

#### Usage

zowe ca7 agent-cred getAgentCredentialsStatus [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--userid` (string)

  - Specifies a user ID that is passed with a password to an agent for authorization.
    Limits:
    1 to 128 characters. The wildcard characters * and ? are not permitted

#### Options

- `--agent` (string)

  - Specifies the agent that is the target of a job submission and where the user ID and password authorization takes place.

    Limits: 1 to 16 characters. The wildcard characters * and ? are not permitted

    Example: WINAGENT001

- `--jobType` (string)

  - Specifies the job type of the job that requires a user ID and password authorization.

    Limits: 1 to 16 characters. The wildcard characters * and ? are not permitted

    Example: NT_JOB

- `--source` (string)

  - Specifies the source field for a job that requires a user ID and password authorization. This property applies to agent job types which allow CONNECTIONUSER or PROXYUSER C-LANG statements.

    Limits: 1 to 64 characters. The wildcard characters * and ? are not permitted

    Example: example.domain.com

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get the Agent credential status associated with a user wlaagent for INSTANCE1:

  - `zowe ca7 agent-cred getAgentCredentialsStatus --userid wlaagent --ca7Id INSTANCE1`

### zowe › ca7 › agent-cred › getAgentCredentialsStatus › 1

Check for the presence of Agent credentials associated with the specified user ID, Agent name, job type and source.

#### Usage

zowe ca7 agent-cred getAgentCredentialsStatus_1 [options]

#### Required Options

- `--userid` (string)

  - Specifies a user ID that is passed with a password to an agent for authorization.
    Limits:
    1 to 128 characters. The wildcard characters * and ? are not permitted

#### Options

- `--agent` (string)

  - Specifies the agent that is the target of a job submission and where the user ID and password authorization takes place.

    Limits: 1 to 16 characters. The wildcard characters * and ? are not permitted

    Example: WINAGENT001

- `--jobType` (string)

  - Specifies the job type of the job that requires a user ID and password authorization.

    Limits: 1 to 16 characters. The wildcard characters * and ? are not permitted

    Example: NT_JOB

- `--source` (string)

  - Specifies the source field for a job that requires a user ID and password authorization. This property applies to agent job types which allow CONNECTIONUSER or PROXYUSER C-LANG statements.

    Limits: 1 to 64 characters. The wildcard characters * and ? are not permitted

    Example: example.domain.com

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get the Agent credential status associated with a user wlaagent:

  - `zowe ca7 agent-cred getAgentCredentialsStatus_1 --userid wlaagent`

### zowe › ca7 › agent-cred › postAgentCredentials

Add Agent credentials to be associated with a user ID, Agent name, job type and source.

#### Usage

zowe ca7 agent-cred postAgentCredentials [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--passwordAG` | `--pwdAG` (string)

  - Specifies the password to associate with the four key fields (userid, agent, jobType, and source)
    Limits:
    1 to 32 characters.

#### Options

- `--userid` (string)

  - Specifies a user ID that is passed with a password to an agent for authorization.
    Limits:
    1 to 128 characters. The wildcard characters * and ? are not permitted

- `--agent` (string)

  - Specifies the agent that is the target of a job submission and where the user ID and password authorization takes place.
    Limits:
    1 to 16 characters. The wildcard characters * and ? are not permitted

- `--jobType` (string)

  - Specifies the job type of the job that requires a user ID and password authorization.
    Limits:
    1 to 16 characters. The wildcard characters * and ? are not permitted

- `--source` (string)

  - Specifies the source field for a job that requires a user ID and password authorization. This field applies to agent job types which allow CONNECTIONUSER or PROXYUSER C-LANG statements. If omitted, it indicates that these credentials are eligible for selection for all source values. If specified, it is used as the domain name when selecting the credentials for the user.
    Limits:
    1 to 64 characters. The wildcard characters * and ? are not permitted

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Add the Agent credential associated with a user wlaagent for INSTANCE1:

  - `zowe ca7 agent-cred postAgentCredentials --userid wlaagent --pwdAG abc --ca7Id INSTANCE1`

### zowe › ca7 › agent-cred › postAgentCredentials › 1

Add Agent credentials to be associated with a user ID, Agent name, job type and source.

#### Usage

zowe ca7 agent-cred postAgentCredentials_1 [options]

#### Options

- `--userid` (string)

  - Specifies a user ID that is passed with a password to an agent for authorization.
    Limits:
    1 to 128 characters. The wildcard characters * and ? are not permitted

- `--agent` (string)

  - Specifies the agent that is the target of a job submission and where the user ID and password authorization takes place.
    Limits:
    1 to 16 characters. The wildcard characters * and ? are not permitted

- `--jobType` (string)

  - Specifies the job type of the job that requires a user ID and password authorization.
    Limits:
    1 to 16 characters. The wildcard characters * and ? are not permitted

- `--source` (string)

  - Specifies the source field for a job that requires a user ID and password authorization. This field applies to agent job types which allow CONNECTIONUSER or PROXYUSER C-LANG statements. If omitted, it indicates that these credentials are eligible for selection for all source values. If specified, it is used as the domain name when selecting the credentials for the user.
    Limits:
    1 to 64 characters. The wildcard characters * and ? are not permitted

#### Required Options

- `--passwordAG` | `--pwdAG` (string)

  - Specifies the password to associate with the four key fields (userid, agent, jobType, and source)
    Limits:
    1 to 32 characters.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Add the Agent credential associated with a user wlaagent:

  - `zowe ca7 agent-cred postAgentCredentials_1 --userid wlaagent --pwdAG abc`

### zowe › ca7 › agent-cred › putAgentCredentials

Update the Agent credentials associated with a user ID, Agent name, job type and source.

#### Usage

zowe ca7 agent-cred putAgentCredentials [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--userid` (string)

  - Specifies a user ID that is passed with a password to an agent for authorization.
    Limits:
    1 to 128 characters. The wildcard characters * and ? are not permitted

- `--passwordAG` | `--pwdAG` (string)

  - Specifies the password currently associated with the four key fields (userid, agent, jobType, and source)
    Limits:
    1 to 32 characters.

- `--newPassword` | `--npwd` (string)

  - Specifies the new password to associate with the four key fields (userid, agent, jobType, and source)
    Limits:
    1 to 32 characters.

#### Options

- `--agent` (string)

  - Specifies the agent that is the target of a job submission and where the user ID and password authorization takes place.
    Limits:
    1 to 16 characters. The wildcard characters * and ? are not permitted

- `--jobType` (string)

  - Specifies the job type of the job that requires a user ID and password authorization.
    Limits:
    1 to 16 characters. The wildcard characters * and ? are not permitted

- `--source` (string)

  - Specifies the source field for a job that requires a user ID and password authorization. This field applies to agent job types which allow CONNECTIONUSER or PROXYUSER C-LANG statements. If omitted, it indicates that these credentials are eligible for selection for all source values. If specified, it is used as the domain name when selecting the credentials for the user.
    Limits:
    1 to 64 characters. The wildcard characters * and ? are not permitted

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Update the Agent credential with a user wlaagent for INSTANCE1:

  - `zowe ca7 agent-cred putAgentCredentials --userid wlaagent --pwdAG abc --npwd def --ca7Id INSTANCE1`

### zowe › ca7 › agent-cred › putAgentCredentials › 1

Update the Agent credentials associated with a user ID, Agent name, job type and source.

#### Usage

zowe ca7 agent-cred putAgentCredentials_1 [options]

#### Required Options

- `--userid` (string)

  - Specifies a user ID that is passed with a password to an agent for authorization.
    Limits:
    1 to 128 characters. The wildcard characters * and ? are not permitted

- `--passwordAG` | `--pwdAG` (string)

  - Specifies the password currently associated with the four key fields (userid, agent, jobType, and source)
    Limits:
    1 to 32 characters.

- `--newPassword` | `--npwd` (string)

  - Specifies the new password to associate with the four key fields (userid, agent, jobType, and source)
    Limits:
    1 to 32 characters.

#### Options

- `--agent` (string)

  - Specifies the agent that is the target of a job submission and where the user ID and password authorization takes place.
    Limits:
    1 to 16 characters. The wildcard characters * and ? are not permitted

- `--jobType` (string)

  - Specifies the job type of the job that requires a user ID and password authorization.
    Limits:
    1 to 16 characters. The wildcard characters * and ? are not permitted

- `--source` (string)

  - Specifies the source field for a job that requires a user ID and password authorization. This field applies to agent job types which allow CONNECTIONUSER or PROXYUSER C-LANG statements. If omitted, it indicates that these credentials are eligible for selection for all source values. If specified, it is used as the domain name when selecting the credentials for the user.
    Limits:
    1 to 64 characters. The wildcard characters * and ? are not permitted

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Update the Agent credential associated with a user wlaagent for INSTANCE1:

  - `zowe ca7 agent-cred putAgentCredentials_1 --userid wlaagent --pwdAG abc --npwd def`

## zowe › ca7 › batch

Multiple API calls in the same CA 7 session

### zowe › ca7 › batch › batch

Call multiple APIs in the same CA 7 session

#### Usage

zowe ca7 batch batch [options]

#### Options

- `--ca7Id` (string)

  - CA 7 instance
    All API requests in the request body will be routed to the ca7Id specified.
    If ca7Id is not specified, all requests will be routed to the DEFAULT_INSTANCE.

- `--body` (array)

  - The request body required for the API specified by path
    Note that double quotes (") in the original API request body should be replaced with single quotes (') in the body value.Required if the method is POST, PUT, or DELETE
    Invalid if the method is GET

- `--parameters` (array)

  - Name/value pairs specified using standard JSON format enclosed in curly brackets { }
    Optional depending upon the path and method

#### Required Options

- `--path` (array)

  - The path as shown in Swagger for the endpoint associated with this API request

- `--method` (array)

  - The API method
    Valid values are POST, PUT or DELETE.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Call multiple APIs(with details of path, method, body, and/or parameters) in the same CA 7 session on Instance1:

  - `zowe ca7 batch batch --ca7Id Instance1 --path path1 --path path2 --method POST --method PUT --body "{body parameters}" --body "{body parameters}"`

## zowe › ca7 › CA7-instances

Retrieve, add, update, or delete a CA 7 instance configuration, including the DEFAULT_INSTANCE

### zowe › ca7 › CA7-instances › delete-instance

Delete an instance from configuration, the instance won't be available for any API requests.

#### Usage

zowe ca7 CA7-instances delete-instance [options]

#### Required Options

- `--instanceName` | `--iname` (string)

  - The CA 7 instance name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes Instance Information for INSTANCE1:

  - `zowe ca7 CA7-instances delete-instance --iname INSTANCE1`

### zowe › ca7 › CA7-instances › get-instance

Retrieve Instance Information

#### Usage

zowe ca7 CA7-instances get-instance [options]

#### Required Options

- `--instanceName` | `--iname` (string)

  - The CA 7 instance name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Retrieve Instance Information for INSTANCE1:

  - `zowe ca7 CA7-instances get-instance --iname INSTANCE1`

### zowe › ca7 › CA7-instances › post-instance

Add a CA 7 instance configuration

#### Usage

zowe ca7 CA7-instances post-instance [options]

#### Required Options

- `--name` (string)

  - The unique name of this instance.
    This is the name to be used in all API requests.

- `--ca7_host` (string)

  - The CA7ONL host IP/DNS.

- `--ca7_port` (number)

  - The CA7ONL port.

#### Options

- `--ca7_secure` (boolean)

  - True, if the communication with CA 7 should use secure sockets.

- `--ca7_keystore` (string)

  - The full path to the keystore/truststore file used for SSL communication to CA7ONL

- `--ca7_keystorePass` (string)

  - The keystore/truststore password
    .

- `--ca7_protocol` (string)

  - The SSL protocol to be used for secure socket communication with CA7ONL.
    The default is TLSv1.2.
    If it is not specified the default will be used.

- `--ca7_communicatorPoolSize` (number)

  - The maximum number of connections to be opened to a CA7ONL instance.
    This must be a positive value that does not exceed the maximum number of terminals.

- `--ca7_communicatorEvictableIdleTimeSeconds` (number)

  - The time, in seconds, to keep an existing connection open.
    If the connection is not used and the idle time passes, the connection will be closed.

- `--ca7_authorizationRetryCount` (number)

  - The number of retries to be used for access to endpoint authorization.
    If HttpStatus.SERVICE_UNAVAILABLE is returned, the authorization will be retried up to ca7_authorizationRetryCount.
    The default is 5.

- `--ca7_timeout` (number)

  - The timeout, in seconds, used when connecting to and reading from CA 7 via the TCP/IP terminal interface.
    The default is 60.

- `--ca7_use_uid_filter` (boolean)

  - Flag to turn on/off the UID/COIDs usage
    Default: false

- `--ca7_pool_retry` (number)

  - How many times to try to get the communicator from the pool
    Default: 10

- `--ca7_pool_retry_timeout` (number)

  - The time interval between 2 attempts to get the communicator from the pool, in milliseconds
    Default: 500

- `--db_logical_name` (string)

  - The logical database name
    If not specified in the instance configuration, the name will need to be passed as a parameter to the request.

- `--db_host` (string)

  - The Datacom server host IP/DNS
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_port` (number)

  - The Datacom server port
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_user` (string)

  - The Datacom user ID
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_password` (string)

  - The Datacom user's password
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_server_name` (string)

  - The Datacom server name
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_secure` (boolean)

  - Flag to be set to true if the connection to db will be done using SSL
    The default is false

- `--db_trustStore` (string)

  - The full path to the keystore/truststore file used for SSL communication to Datacom

- `--db_trustPass` (string)

  - The keystore/truststore password
    .

- `--db_protocol` (string)

  - The SSL protocol to be used for secure socket communication with Datacom.
    The default is TLSv1.2.
    If it is not specified, the default will be used.

- `--db_max_pool` (number)

  - The maximum number of Datacom connections to be available in the same time.
    Default: 10

- `--db_min_pool` (number)

  - The minimum number of Datacom connections to be kept idle when they are not used
    Default: 0

- `--db_timeout` (number)

  - The connection to Datacom timeout in seconds
    Default: 60

- `--db_trace` (boolean)

  - Flag to turn on/off the jdbc trace on the RestApi side for Datacom queries
    Default: false

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Add specified CA 7 instance configuration:

  - `zowe ca7 CA7-instances post-instance --name INSTANCE1 --ca7_host myhost.domain.com --ca7_port 12345`

### zowe › ca7 › CA7-instances › post-list-instance

Find all configured instances that have all the properties in the request

#### Usage

zowe ca7 CA7-instances post-list-instance [options]

#### Options

- `--name` (string)

  - The unique name of this instance.
    This is the name to be used in all API requests.

- `--ca7_host` (string)

  - The CA7ONL host IP/DNS.

- `--ca7_port` (number)

  - The CA7ONL port.

- `--ca7_secure` (boolean)

  - True, if the communication with CA 7 should use secure sockets.

- `--ca7_keystore` (string)

  - The full path to the keystore/truststore file used for SSL communication to CA7ONL

- `--ca7_protocol` (string)

  - The SSL protocol to be used for secure socket communication with CA7ONL.
    The default is TLSv1.2.
    If it is not specified the default will be used.

- `--ca7_communicatorPoolSize` (number)

  - The maximum number of connections to be opened to a CA7ONL instance.
    This must be a positive value that does not exceed the maximum number of terminals.

- `--ca7_communicatorEvictableIdleTimeSeconds` (number)

  - The time, in seconds, to keep an existing connection open.
    If the connection is not used and the idle time passes, the connection will be closed.

- `--ca7_authorizationRetryCount` (number)

  - The number of retries to be used for access to endpoint authorization.
    If HttpStatus.SERVICE_UNAVAILABLE is returned, the authorization will be retried up to ca7_authorizationRetryCount.
    The default is 5.

- `--ca7_timeout` (number)

  - The timeout, in seconds, used when connecting to and reading from CA 7 via the TCP/IP terminal interface.
    The default is 60.

- `--ca7_use_uid_filter` (boolean)

  - Flag to turn on/off the UID/COIDs usage
    Default: false

- `--ca7_pool_retry` (number)

  - How many times to try to get the communicator from the pool
    Default: 10

- `--ca7_pool_retry_timeout` (number)

  - The time interval between 2 attempts to get the communicator from the pool, in milliseconds
    Default: 500

- `--db_logical_name` (string)

  - The logical database name
    If not specified in the instance configuration, the name will need to be passed as a parameter to the request.

- `--db_host` (string)

  - The Datacom server host IP/DNS
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_port` (number)

  - The Datacom server port
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_user` (string)

  - The Datacom user ID
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_server_name` (string)

  - The Datacom server name
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_secure` (boolean)

  - Flag to be set to true if the connection to db will be done using SSL
    The default is false

- `--db_trustStore` (string)

  - The full path to the keystore/truststore file used for SSL communication to Datacom

- `--db_protocol` (string)

  - The SSL protocol to be used for secure socket communication with Datacom.
    The default is TLSv1.2.
    If it is not specified, the default will be used.

- `--db_max_pool` (number)

  - The maximum number of Datacom connections to be available in the same time.
    Default: 10

- `--db_min_pool` (number)

  - The minimum number of Datacom connections to be kept idle when they are not used
    Default: 0

- `--db_timeout` (number)

  - The connection to Datacom timeout in seconds
    Default: 60

- `--db_trace` (boolean)

  - Flag to turn on/off the jdbc trace on the RestApi side for Datacom queries
    Default: false

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Find all configured instances that have all the properties in the request:

  - `zowe ca7 CA7-instances post-list-instance --name INSTANCE1 --ca7_host myhost.domain.com --ca7_port 12345`

### zowe › ca7 › CA7-instances › put-instance

Update a CA 7 Instance Configuration

#### Usage

zowe ca7 CA7-instances put-instance [options]

#### Required Options

- `--name` (string)

  - The unique name of this instance.
    This is the name to be used in all API requests
    .

- `--ca7_host` (string)

  - The CA7ONL host IP/DNS
    .

- `--ca7_port` (number)

  - The CA7ONL port
    .

#### Options

- `--ca7_secure` (boolean)

  - True, if the communication with CA 7 should use secure sockets.

- `--ca7_keystore` (string)

  - The full path to the keystore/truststore file used for SSL communication to CA7ONL

- `--ca7_keystorePass` (string)

  - The keystore/truststore password
    .

- `--ca7_protocol` (string)

  - The SSL protocol to be used for secure socket communication with CA7ONL.
    The default is TLSv1.2.
    If it is not specified the default will be used.

- `--ca7_communicatorPoolSize` (number)

  - The maximum number of connections to be opened to a CA7ONL instance.
    This must be a positive value that does not exceed the maximum number of terminals.

- `--ca7_communicatorEvictableIdleTimeSeconds` (number)

  - The time, in seconds, to keep an existing connection open.
    If the connection is not used and the idle time passes, the connection will be closed.

- `--ca7_authorizationRetryCount` (number)

  - The number of retries to be used for access to endpoint authorization.
    If HttpStatus.SERVICE_UNAVAILABLE is returned, the authorization will be retried up to ca7_authorizationRetryCount.
    The default is 5.

- `--ca7_timeout` (number)

  - The timeout, in seconds, used when connecting to and reading from CA 7 via the TCP/IP terminal interface.
    The default is 60.

- `--ca7_use_uid_filter` (boolean)

  - Flag to turn on/off the UID/COIDs usage
    Default: false

- `--ca7_pool_retry` (number)

  - How many times to try to get the communicator from the pool
    Default: 10

- `--ca7_pool_retry_timeout` (number)

  - The time interval between 2 attempts to get the communicator from the pool, in milliseconds
    Default: 500

- `--db_logical_name` (string)

  - The logical database name
    If not specified in the instance configuration, the name will need to be passed as a parameter to the request.

- `--db_host` (string)

  - The Datacom server host IP/DNS
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_port` (number)

  - The Datacom server port
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_user` (string)

  - The Datacom user ID
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_password` (string)

  - The Datacom user's password
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_server_name` (string)

  - The Datacom server name
    If not specified in the instance configuration, all the requests that requires Datacom connection will fail

- `--db_secure` (boolean)

  - Flag to be set to true if the connection to db will be done using SSL
    The default is false

- `--db_trustStore` (string)

  - The full path to the keystore/truststore file used for SSL communication to Datacom

- `--db_trustPass` (string)

  - The keystore/truststore password
    .

- `--db_protocol` (string)

  - The SSL protocol to be used for secure socket communication with Datacom.
    The default is TLSv1.2.
    If it is not specified, the default will be used.

- `--db_max_pool` (number)

  - The maximum number of Datacom connections to be available in the same time.
    Default: 10

- `--db_min_pool` (number)

  - The minimum number of Datacom connections to be kept idle when they are not used
    Default: 0

- `--db_timeout` (number)

  - The connection to Datacom timeout in seconds
    Default: 60

- `--db_trace` (boolean)

  - Flag to turn on/off the jdbc trace on the RestApi side for Datacom queries
    Default: false

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Update a CA 7 Instance Configuration for specified instance:

  - `zowe ca7 CA7-instances put-instance --name INSTANCE1 --ca7_host myhost.domain.com --ca7_port 12345`

## zowe › ca7 › commands

All the available commands are listed in the COMMANDS section.

### zowe › ca7 › commands › addrq

The ADDRQ command manually adds temporary, one-time, preexecution user or predecessor job requirements.
These requirements must be added to the job while it is in the CA Workload Automation CA 7 Edition
request queue. These added requirements apply only to the current run of the job.
You must manually satisfy user requirements with the QM.2 panel (POST) or XRQ command before the job executes.
Predecessor job requirements are satisfied automatically when the predecessor job completes successfully.

#### Usage

zowe ca7 commands addrq [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Defines the job to which you want to add the job requirement.
    The job must be in the request queue.
    jobnumber
    Defines the CA 7 job number to which you want to add the requirement for this run of the job.
    Limits:
    1 to 4 numeric characters

- `--depjob` (string)

  - Defines a temporary one-time job dependency requirement.
    The DEPJOB value specifies the job name that must complete execution or must be manually posted complete before the job identified by JOB is eligible for submission.
    DEPJOB is required unless USR is used, in which case, omit DEPJOB.
    This requirement is satisfied automatically when the predecessor job completes.
    Only in unusual situations would this requirement must be satisfied manually. That is, any time that a normal completion did not occur.
    Required: Yes, unless USR is used.
    Limits:
    1 to 8 alphanumeric characters

- `--usr` (string)

  - Defines the description of a temporary, one-time user requirement..
    This requirement must be manually satisfied before the job identified by JOB is eligible for submission.
    If any commas are included as part of the text, enclose the entire requirements text in parentheses.
    This requirement is satisfied automatically when the predecessor job completes.
    Only in unusual situations would this requirement must be satisfied manually. That is, any time that a normal completion did not occur.
    Required: USR is required unless DEPJOB is used, in which case, omit USR.
    Limits:
    1 to 36 alphanumeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Adds the job requirement ca7 number, 0016 from CA 7 on Instance1:

  - `zowe ca7 commands addrq --ca7# 0016 --ca7Id Instance1`

### zowe › ca7 › commands › addrq › 1

The ADDRQ command manually adds temporary, one-time, preexecution user or predecessor job requirements.
These requirements must be added to the job while it is in the CA Workload Automation CA 7 Edition
request queue. These added requirements apply only to the current run of the job.
You must manually satisfy user requirements with the QM.2 panel (POST) or XRQ command before the job executes.
Predecessor job requirements are satisfied automatically when the predecessor job completes successfully.

#### Usage

zowe ca7 commands addrq_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Defines the job to which you want to add the job requirement.
    The job must be in the request queue.
    jobnumber
    Defines the CA 7 job number to which you want to add the requirement for this run of the job.
    Limits:
    1 to 4 numeric characters

- `--depjob` (string)

  - Defines a temporary one-time job dependency requirement.
    The DEPJOB value specifies the job name that must complete execution or must be manually posted complete before the job identified by JOB is eligible for submission.
    DEPJOB is required unless USR is used, in which case, omit DEPJOB.
    This requirement is satisfied automatically when the predecessor job completes.
    Only in unusual situations would this requirement must be satisfied manually. That is, any time that a normal completion did not occur.
    Required: Yes, unless USR is used.
    Limits:
    1 to 8 alphanumeric characters

- `--usr` (string)

  - Defines the description of a temporary, one-time user requirement..
    This requirement must be manually satisfied before the job identified by JOB is eligible for submission.
    If any commas are included as part of the text, enclose the entire requirements text in parentheses.
    This requirement is satisfied automatically when the predecessor job completes.
    Only in unusual situations would this requirement must be satisfied manually. That is, any time that a normal completion did not occur.
    Required: USR is required unless DEPJOB is used, in which case, omit USR.
    Limits:
    1 to 36 alphanumeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Adds the job requirement ca7 number, 0016 from CA 7:

  - `zowe ca7 commands addrq_1 --ca7# 0016`

### zowe › ca7 › commands › arfp

The ARFP command purges the ARF requirement for a job in the request, ready, or active queue

#### Usage

zowe ca7 commands arfp [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Defines the unique CA 7 job number for the job whose ARF requirements you want to purge.

- `--force` (string)

  - (Optional)If set to YES,forces the purging of the ARF requirement for a job
    even if it does not exist in the request, ready, or active queue.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Adds the ARF requirement for Instance1 and ca7 number 0016 from CA 7:

  - `zowe ca7 commands arfp --ca7Id Instance1 --ca7# 0016`

### zowe › ca7 › commands › arfp › 1

The ARFP command purges the ARF requirement for a job in the request, ready, or active queue

#### Usage

zowe ca7 commands arfp_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Defines the unique CA 7 job number for the job whose ARF requirements you want to purge.

- `--force` (string)

  - (Optional)If set to YES,forces the purging of the ARF requirement for a job
    even if it does not exist in the request, ready, or active queue.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Adds the ARF requirement for ca7 number 0016 from CA 7:

  - `zowe ca7 commands arfp_1 --ca7# 0016`

### zowe › ca7 › commands › cancel

The CANCEL command deletes jobs from the CA Workload Automation CA 7® Edition queues.

For CPU jobs, the CANCEL command only removes the job from the queues.
Cancelation of a job in the active queue or ready queue (if it has been submitted)
does not cause termination of the job's execution.
CPU jobs that can be executing have to be canceled from the operating system separately.
Execution must be terminated from an OS system console.
For XPJOB jobs, the CANCEL command removes the job from the queues.
If the XPDEF initialization option XPKILL is set to YES,
and the XPJOB job has been submitted to the target node but is still in the ready queue or the active queue,
a cancel request is created and sent to the target node.
Some remote CA Scheduling Agents support the cancel request, and the request cancels or 'kills' the process execution.
It is not the responsibility of CA WA CA 7 Edition to verify that the target platform supports the kill facility.
If the cancel request was not transmitted, an error message appears in the browse and log data.
For agent definition jobs (AGJOBs), the CANCEL command sends a request to the agent and removes the job from the queues.
If the agent is not active at the time of the CANCEL request, the message is queued and sent when the agent becomes active.
If the XPDEF initialization option XPKILL is set to NO, the XPJOB is canceled from the queues, and no cancel request is sent to the target platform.
To view the XPKILL option, enter the command /DISPLAY,ST=XPS.

This function is available on the QM.1, QM.6, and QM.7 panels as option C.
The CANCEL command has three formats, depending on the queues in which the task resides.

#### Usage

zowe ca7 commands cancel [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Indicates the individual job to cancel, and the value must be a CA 7 job number.

- `--force` (string)

  - (Optional) Specifies to force the cancellation of the job.
    If you want to cancel the job to dump the log data set, specify FORCE=YES to prevent the job from being resubmitted.
    Use FORCE=YES when a job to be canceled shows a status of SKELETON or RETRY.
    Use FORCE=YES to cancel a job with connected resources.
    Warning! Use of this option can potentially cause CA WA CA 7 Edition to abend; therefore, only use it as a last resort.

- `--reason` (string)

  - (Optional) Defines the reason for the job cancellation.
    Depending on the initialization file CANCEL statement value, this reason can be required or optional.
    If it is required but not given, a message prompts the user to provide it.
    The text is entered into the run log entry for this occurrence of this job and is displayed on any subsequent LRLOG inquiries.
    Limits:
    1 to 40 alphanumeric characters
    Required:
    No (depending on initialization options)

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Cancels a job request for Instance1 and ca7 number 0016 from CA 7:

  - `zowe ca7 commands cancel --ca7Id Instance1 --ca7# 0016`

### zowe › ca7 › commands › cancel › 1

The CANCEL command deletes jobs from the CA Workload Automation CA 7® Edition queues.

For CPU jobs, the CANCEL command only removes the job from the queues.
Cancelation of a job in the active queue or ready queue (if it has been submitted)
does not cause termination of the job's execution.
CPU jobs that can be executing have to be canceled from the operating system separately.
Execution must be terminated from an OS system console.
For XPJOB jobs, the CANCEL command removes the job from the queues.
If the XPDEF initialization option XPKILL is set to YES,
and the XPJOB job has been submitted to the target node but is still in the ready queue or the active queue,
a cancel request is created and sent to the target node.
Some remote CA Scheduling Agents support the cancel request, and the request cancels or 'kills' the process execution.
It is not the responsibility of CA WA CA 7 Edition to verify that the target platform supports the kill facility.
If the cancel request was not transmitted, an error message appears in the browse and log data.
For agent definition jobs (AGJOBs), the CANCEL command sends a request to the agent and removes the job from the queues.
If the agent is not active at the time of the CANCEL request, the message is queued and sent when the agent becomes active.
If the XPDEF initialization option XPKILL is set to NO, the XPJOB is canceled from the queues, and no cancel request is sent to the target platform.
To view the XPKILL option, enter the command /DISPLAY,ST=XPS.

This function is available on the QM.1, QM.6, and QM.7 panels as option C.
The CANCEL command has three formats, depending on the queues in which the task resides.

#### Usage

zowe ca7 commands cancel_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Indicates the individual job to cancel, and the value must be a CA 7 job number.

- `--force` (string)

  - (Optional) Specifies to force the cancellation of the job.
    If you want to cancel the job to dump the log data set, specify FORCE=YES to prevent the job from being resubmitted.
    Use FORCE=YES when a job to be canceled shows a status of SKELETON or RETRY.
    Use FORCE=YES to cancel a job with connected resources.
    Warning! Use of this option can potentially cause CA WA CA 7 Edition to abend; therefore, only use it as a last resort.

- `--reason` (string)

  - (Optional) Defines the reason for the job cancellation.
    Depending on the initialization file CANCEL statement value, this reason can be required or optional.
    If it is required but not given, a message prompts the user to provide it.
    The text is entered into the run log entry for this occurrence of this job and is displayed on any subsequent LRLOG inquiries.
    Limits:
    1 to 40 alphanumeric characters
    Required:
    No (depending on initialization options)

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Cancels a job request for ca7 number 0016 from CA 7:

  - `zowe ca7 commands cancel_1 --ca7# 0016`

### zowe › ca7 › commands › demand

The DEMAND command forces immediate scheduling of a job into the CA Workload Automation CA 7® Edition request queue.
Jobs that do not have definable processing cycles can be scheduled in this manner.
Demand scheduling can also be used to force an early execution of jobs that have defined processing cycles
or to schedule jobs for the first time, before they have been defined in the database.

#### Usage

zowe ca7 commands demand [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--job` (string)

  - Defines the name xxx of the job being demanded.
    The demanded jobs are placed in the request queue and assigned a unique CA 7 job number.
    JOB and JOBL are mutually exclusive
    Limits:
    1 to 8 alphanumeric characters

- `--jobl` (string)

  - (Optional) Defines the long name of the job being demanded. The demanded jobs are placed in the request queue and assigned a unique CA 7 job number.
    JOB and JOBL are mutually exclusive
    Limits:
    1 to 64 alphanumeric characters

- `--arfset` (string)

  - (Optional)Defines the ARF set name that is used for this run of the job.
    you specify **NONE**, no ARF processing is performed for this run of the job
    Limits:
    1 to 4 alphanumeric characters

- `--cc` (string)

  - (Optional)Defines, with RO (relational operator), the job-level condition codes that are used to determine whether a job executes successfully.
    If specified, this value overrides the RO defined for the job in the CA WA CA 7 Edition database.
    RO is required when CC is specified
    Limits:
    1 to 4 numeric characters(0-4095)

- `--class` (string)

  - (Optional)Defines the workload balancing class for resource checking.
    Limits:
    1 alphanumeric character

- `--count` (string)

  - Defines the maximum number of times to repeat the job. COUNT is ignored if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating when the COUNT reaches zero or the STOP time is reached, whichever comes first.
    Default: None. The job continues repeating until the STOP time is reached
    Limits:
    1 to 4 numeric characters(0-1439)

- `--date` (string)

  - (Optional)Defines due-out and submit dates.
    Limits:
    If used, specify DOTM or TIME. +nn
    Defines the number of days after the current date.
    Limits:
    1 to 2 numeric characters from 1 to 99
    yyddd Defines the Julian date to run the job.

- `--depjob` (string)

  - (Optional)Defines a single predecessor job that must complete while the demanded job is waiting.
    Limits:
    1 to 8 alphanumeric characters

- `--dotm` (string)

  - (Optional)Defines the due-out time-of-day for the job in hours (hh) and minutes (mm).
    If omitted, the current time (when the DEMAND was processed) plus the lead time is assumed.
    If DOTM is specified on the DEMAND/DEMANDH command and the value that is given is earlier than the current time, the due-out day is assumed to be the following day.
    If DOTM and LEADTM are both omitted, then deadline start time is assumed to be the current time plus the LEADTM.
    Default: Current time, hhmm

- `--exec` (string)

  - (Optional)Specifies whether to execute the job (YES/NO).
    If NO (N) is used, the job does not run but shows a normal completion as if it did run.
    The value that is specified here overrides the value that is coded on the job definition EXEC field.
    Default: The job definition panel EXEC value if the job is defined to CA WA CA 7 Edition; otherwise YES,
    Values:YES|Y, NO|N

- `--interval` (string)

  - (Optional)Identifies that the job is repeated (executed more than once) and defines the amount of time between each iteration.
    If INTERVAL is specified, the TIME and TYPE keywords are required.
    If both INTERVAL and COUNT are specified, the INTERVAL value times the COUNT value must total less than 24 hours.
    For information about how the deadline, due-out, and submit times are calculated for repeating jobs, see the Usage Notes.
    Default: None. The job is not repeated.
    Limits:
    hh=1 through 2 numeric charact, hhmm

- `--jclid` (string)

  - (Optional)Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a numeric INDEX associated with the wanted JCL data set (on the JCL statement in the initialization file).
    If the job is defined in the database, the value must be the same as the value on the DB.1 panel
    or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLLIB field is required if the job is not defined in the database.
    JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed,

    Limits:
    1 to 3 numeric characters(1-999)

- `--jcllib` (string)

  - (Optional)Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a symbolic INDEX associated with the wanted JCL data set (on the JCL statement in the initialization file).
    If the job is defined in the database, the value must be the same as the value on the DB.1 panel
    or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLID field is required if the job is not defined in the database. JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed
    1 to 3 numeric characters from 0 through 254 and from 256 through 999. 255 is reserved.

- `--late` (string)

  - (Optional)Specifies whether a notification occurs when the job becomes late.
    Specify YES (Y) to make the job eligible to be marked LATE.
    If NO (N) is used, the job is never marked LATE.
    The value that is specified here overrides the value that is coded on the job definition PROMPTS field,
    Values:YES|Y, NO|N

- `--leadtm` (string)

  - (Optional)Defines the amount of elapsed time that is required to process the job.
    Indicates in hours (hh) and minutes (mm) the elapsed time.
    The maximum value that you can specify is 2400.
    Default: 1 hour
    Limits:
    hh= 1 through 2 numeric characters from 0 to 24
    mm= 2 numeric characters from 00 to 59

- `--mainid` (string)

  - (Optional)Specifies the MAINID, as defined in the initialization file CPU statement, to which you want to redirect the job.
    The value that is specified here overrides the value that is coded on the job definition MAINID field.
    Also, the SASSXX05 user exit does not override this value.
    The name must be one of the following values: ALL Specifies all CPUs are acceptable for executing the job. SYn n defines the CPU to which the job is being redirected. The value of n can range from 1 to 7. /SYn n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7. -SYn n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.Limits:
    Invalid for internal cross-platform jobs.

- `--prty` (string)

  - (Optional)Defines the initial workload balancing priority,
    1-3 numeric (1-255)

- `--rms` (string)

  - (Optional)Specifies whether CA WA CA 7 Edition inserts the CA Workload Automation Restart_XXX Option for z/OS Schedulers RMS step.
    Specify YES (Y) to insert the step with the CA Workload Automation Restart_XXX Option for z/OS Schedulers processing code of P.Enter NO (N) to indicate do not insert of the RMS step.
    The value that is specified here overrides the value that is coded on the job definition INSERT-RMS field.
    Default: The job definition panel INSERT-RMS value if job defined to CA WA CA 7 Edition; otherwise NO.
    Limits:
    Invalid for internal cross-platform jobs
    , Values: YES|Y, NO|N

- `--ro` (string)

  - (Optional)Specifies the relational operator of the condition code (CC) or
    if the step level #SCC statements are being used in the JCL of the job.
    If specified, this RO overrides the RO defined for the job in the CA WA CA 7 Edition database.
    The following values are valid:
    EQ
    Equal to LT
    Less than GT
    Greater than GE
    Greater than or equal to LE
    Less than or equal to NE
    Not equal to #S
    Step condition code tests to be made based on a #SCC statement. IG
    No evaluation of the job is done.
    CA WA CA 7 Edition always assumes that the job completes successfully,
    regardless of condition codes, abend codes, or run-time JCL errors. 0
    No condition code test is made.Default:
    The job definition panel RO value if the job is defined to CA WA CA 7 Edition; otherwise 0.
    Limits:

    Invalid with agent jobs.

- `--schid` (string)

  - Defines the schedule ID within the job's total schedule definition to use for this run.
    If omitted, SCHID=1 is assumed unless the job exists in the CA WA CA 7 Edition database and has an associated schedule.
    In this case, the first SCHID defined in the schedule member is assumed.
    Default: 1,
    Limits:
    1 to 3 numeric characters from 1 to 999 (See Note)
    Note: If the SCHEDULE statement in the initialization file specifies SCHID=YES, this parameter is required.

- `--set` (string)

  - (Optional)Specifies skip the next scheduled cycle for the job (SKP),
    disable triggering (NTR), or bypass the database updating at the job completion.
    SKP
    Specifies this run of the job takes the place of the next scheduled run.
    This value has the same effect as entering NXTCYC,SET=SKP.
    It is reflected on output from LJOB and LLOCK commands as if NXTCYC,SET=SKP was used.
    This parameter is invalid if the job has no schedule.
    SET=SKP has no impact on repeating jobs that are already in the queues. NTR
    Specifies normal triggering is disabled only for this run of the job. NDB
    Allows a job to bypass all load processing at the job completion,
    but allows other processing to proceed typically.
    Note: Data set triggering is still in effect.
    , SKP|NTR|NDB

- `--stop` (string)

  - (Optional)Defines the clock time after which the job is not repeated.
    STOP is ignored if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating when either the COUNT reaches zero or the STOP time is reached, whichever comes first.
    If the STOP time is less than the submit time, the stop date is assumed to be the following day.
    Default:
    1439 minutes (24 hours minus 1 minute) after the submit time
    Limits:

    hh=1 through 2 numeric characters from 0 to 23
    mm=2 numeric characters from 00 to 59

- `--time` (string)

  - (Optional)Defines a submit time-of-day requirement for the job.
    If the format is used with a +, the submit time is calculated from the current time, adding the specified number of hours and minutes.
    If the + is used, the DATE keyword must be omitted.
    Limits:

    + is optional
    hh= 1 through 2 numeric characters from 0 to 23
    mm= 2 numeric characters from 00 to 59
    Required:

    No (unless DATE is used, if so, specify DOTM or TIME (hhmm format). Also required if TYPE=CLOCK is specified.

- `--type` (string)

  - (Optional)TYPE=RES specifies the job is being scheduled in restart/rerun status.
    TYPE=CLOCK, START, or END controls how the submit time requirement is calculated for repeating jobs.

    When TYPE=RES the job is put into the request queue with a restart requirement.
    The job is not submitted before the CA WA CA 7 Edition restart is done.
    The output networks are scheduled, but input requirements checking is bypassed.
    TYPE=CLOCK, START, or END is ignored if INTERVAL is not specified.
    With TYPE=CLOCK, the interval is added to the previous iteration's submit time requirement to determine the new submit time requirement.
    With TYPE=START and END the interval is added to the previous iteration's last (most recent) start and end time,
    respectively, to determine the new submit time requirement. TYPE is required when INTERVAL is specified.
    Limits:

    RES, CLOCK, START, or END

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Demand job, PAYROLL to CA 7 on Instance1:

  - `zowe ca7 commands demand --ca7Id Instance1 --job PAYROLL`

### zowe › ca7 › commands › demand › 1

The DEMAND command forces immediate scheduling of a job into the CA Workload Automation CA 7® Edition request queue.
Jobs that do not have definable processing cycles can be scheduled in this manner.
Demand scheduling can also be used to force an early execution of jobs that have defined processing cycles
or to schedule jobs for the first time, before they have been defined in the database.

#### Usage

zowe ca7 commands demand_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--job` (string)

  - Defines the name xxx of the job being demanded.
    The demanded jobs are placed in the request queue and assigned a unique CA 7 job number.
    JOB and JOBL are mutually exclusive
    Limits:
    1 to 8 alphanumeric characters

- `--jobl` (string)

  - (Optional) Defines the long name of the job being demanded. The demanded jobs are placed in the request queue and assigned a unique CA 7 job number.
    JOB and JOBL are mutually exclusive
    Limits:
    1 to 64 alphanumeric characters

- `--arfset` (string)

  - (Optional)Defines the ARF set name that is used for this run of the job.
    you specify **NONE**, no ARF processing is performed for this run of the job
    Limits:
    1 to 4 alphanumeric characters

- `--cc` (string)

  - (Optional)Defines, with RO (relational operator), the job-level condition codes that are used to determine whether a job executes successfully.
    If specified, this value overrides the RO defined for the job in the CA WA CA 7 Edition database.
    RO is required when CC is specified
    Limits:
    1 to 4 numeric characters(0-4095)

- `--class` (string)

  - (Optional)Defines the workload balancing class for resource checking.
    Limits:
    1 alphanumeric character

- `--count` (string)

  - Defines the maximum number of times to repeat the job. COUNT is ignored if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating when the COUNT reaches zero or the STOP time is reached, whichever comes first.
    Default: None. The job continues repeating until the STOP time is reached
    Limits:
    1 to 4 numeric characters(0-1439)

- `--date` (string)

  - (Optional)Defines due-out and submit dates.
    Limits:
    If used, specify DOTM or TIME. +nn
    Defines the number of days after the current date.
    Limits:
    1 to 2 numeric characters from 1 to 99
    yyddd Defines the Julian date to run the job.

- `--depjob` (string)

  - (Optional)Defines a single predecessor job that must complete while the demanded job is waiting.
    Limits:
    1 to 8 alphanumeric characters

- `--dotm` (string)

  - (Optional)Defines the due-out time-of-day for the job in hours (hh) and minutes (mm).
    If omitted, the current time (when the DEMAND was processed) plus the lead time is assumed.
    If DOTM is specified on the DEMAND/DEMANDH command and the value that is given is earlier than the current time, the due-out day is assumed to be the following day.
    If DOTM and LEADTM are both omitted, then deadline start time is assumed to be the current time plus the LEADTM.
    Default: Current time, hhmm

- `--exec` (string)

  - (Optional)Specifies whether to execute the job (YES/NO).
    If NO (N) is used, the job does not run but shows a normal completion as if it did run.
    The value that is specified here overrides the value that is coded on the job definition EXEC field.
    Default: The job definition panel EXEC value if the job is defined to CA WA CA 7 Edition; otherwise YES,
    Values:YES|Y, NO|N

- `--interval` (string)

  - (Optional)Identifies that the job is repeated (executed more than once) and defines the amount of time between each iteration.
    If INTERVAL is specified, the TIME and TYPE keywords are required.
    If both INTERVAL and COUNT are specified, the INTERVAL value times the COUNT value must total less than 24 hours.
    For information about how the deadline, due-out, and submit times are calculated for repeating jobs, see the Usage Notes.
    Default: None. The job is not repeated.
    Limits:
    hh=1 through 2 numeric charact, hhmm

- `--jclid` (string)

  - (Optional)Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a numeric INDEX associated with the wanted JCL data set (on the JCL statement in the initialization file).
    If the job is defined in the database, the value must be the same as the value on the DB.1 panel
    or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLLIB field is required if the job is not defined in the database.
    JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed,

    Limits:
    1 to 3 numeric characters(1-999)

- `--jcllib` (string)

  - (Optional)Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a symbolic INDEX associated with the wanted JCL data set (on the JCL statement in the initialization file).
    If the job is defined in the database, the value must be the same as the value on the DB.1 panel
    or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLID field is required if the job is not defined in the database. JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed
    1 to 3 numeric characters from 0 through 254 and from 256 through 999. 255 is reserved.

- `--late` (string)

  - (Optional)Specifies whether a notification occurs when the job becomes late.
    Specify YES (Y) to make the job eligible to be marked LATE.
    If NO (N) is used, the job is never marked LATE.
    The value that is specified here overrides the value that is coded on the job definition PROMPTS field,
    Values:YES|Y, NO|N

- `--leadtm` (string)

  - (Optional)Defines the amount of elapsed time that is required to process the job.
    Indicates in hours (hh) and minutes (mm) the elapsed time.
    The maximum value that you can specify is 2400.
    Default: 1 hour
    Limits:
    hh= 1 through 2 numeric characters from 0 to 24
    mm= 2 numeric characters from 00 to 59

- `--mainid` (string)

  - (Optional)Specifies the MAINID, as defined in the initialization file CPU statement, to which you want to redirect the job.
    The value that is specified here overrides the value that is coded on the job definition MAINID field.
    Also, the SASSXX05 user exit does not override this value.
    The name must be one of the following values: ALL Specifies all CPUs are acceptable for executing the job. SYn n defines the CPU to which the job is being redirected. The value of n can range from 1 to 7. /SYn n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7. -SYn n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.
    Limits:
    Invalid for internal cross-platform jobs.

- `--prty` (string)

  - (Optional)Defines the initial workload balancing priority,
    1-3 numeric (1-255)

- `--rms` (string)

  - (Optional)Specifies whether CA WA CA 7 Edition inserts the CA Workload Automation Restart_XXX Option for z/OS Schedulers RMS step.
    Specify YES (Y) to insert the step with the CA Workload Automation Restart_XXX Option for z/OS Schedulers processing code of P.Enter NO (N) to indicate do not insert of the RMS step.
    The value that is specified here overrides the value that is coded on the job definition INSERT-RMS field.
    Default: The job definition panel INSERT-RMS value if job defined to CA WA CA 7 Edition; otherwise NO.
    Limits:
    Invalid for internal cross-platform jobs
    , Values: YES|Y, NO|N

- `--ro` (string)

  - (Optional)Specifies the relational operator of the condition code (CC) or
    if the step level #SCC statements are being used in the JCL of the job.
    If specified, this RO overrides the RO defined for the job in the CA WA CA 7 Edition database.
    The following values are valid:
    EQ
    Equal to LT
    Less than GT
    Greater than GE
    Greater than or equal to LE
    Less than or equal to NE
    Not equal to #S
    Step condition code tests to be made based on a #SCC statement. IG
    No evaluation of the job is done.
    CA WA CA 7 Edition always assumes that the job completes successfully,
    regardless of condition codes, abend codes, or run-time JCL errors. 0
    No condition code test is made.Default:
    The job definition panel RO value if the job is defined to CA WA CA 7 Edition; otherwise 0.
    Limits:

    Invalid with agent jobs.

- `--schid` (string)

  - Defines the schedule ID within the job's total schedule definition to use for this run.
    If omitted, SCHID=1 is assumed unless the job exists in the CA WA CA 7 Edition database and has an associated schedule.
    In this case, the first SCHID defined in the schedule member is assumed.
    Default: 1,
    Limits:
    1 to 3 numeric characters from 1 to 999 (See Note)
    Note: If the SCHEDULE statement in the initialization file specifies SCHID=YES, this parameter is required.

- `--set` (string)

  - (Optional)Specifies skip the next scheduled cycle for the job (SKP),
    disable triggering (NTR), or bypass the database updating at the job completion.
    SKP
    Specifies this run of the job takes the place of the next scheduled run.
    This value has the same effect as entering NXTCYC,SET=SKP.
    It is reflected on output from LJOB and LLOCK commands as if NXTCYC,SET=SKP was used.
    This parameter is invalid if the job has no schedule.
    SET=SKP has no impact on repeating jobs that are already in the queues. NTR
    Specifies normal triggering is disabled only for this run of the job. NDB
    Allows a job to bypass all load processing at the job completion,
    but allows other processing to proceed typically.
    Note: Data set triggering is still in effect.
    , SKP|NTR|NDB

- `--stop` (string)

  - (Optional)Defines the clock time after which the job is not repeated.
    STOP is ignored if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating when either the COUNT reaches zero or the STOP time is reached, whichever comes first.
    If the STOP time is less than the submit time, the stop date is assumed to be the following day.
    Default:
    1439 minutes (24 hours minus 1 minute) after the submit time
    Limits:

    hh=1 through 2 numeric characters from 0 to 23
    mm=2 numeric characters from 00 to 59

- `--time` (string)

  - (Optional)Defines a submit time-of-day requirement for the job.
    If the format is used with a +, the submit time is calculated from the current time, adding the specified number of hours and minutes.
    If the + is used, the DATE keyword must be omitted.
    Limits:

    + is optional
    hh= 1 through 2 numeric characters from 0 to 23
    mm= 2 numeric characters from 00 to 59
    Required:

    No (unless DATE is used, if so, specify DOTM or TIME (hhmm format). Also required if TYPE=CLOCK is specified.

- `--type` (string)

  - (Optional)TYPE=RES specifies the job is being scheduled in restart/rerun status.
    TYPE=CLOCK, START, or END controls how the submit time requirement is calculated for repeating jobs.

    When TYPE=RES the job is put into the request queue with a restart requirement.
    The job is not submitted before the CA WA CA 7 Edition restart is done.
    The output networks are scheduled, but input requirements checking is bypassed.
    TYPE=CLOCK, START, or END is ignored if INTERVAL is not specified.
    With TYPE=CLOCK, the interval is added to the previous iteration's submit time requirement to determine the new submit time requirement.
    With TYPE=START and END the interval is added to the previous iteration's last (most recent) start and end time,
    respectively, to determine the new submit time requirement. TYPE is required when INTERVAL is specified.
    Limits:

    RES, CLOCK, START, or END

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Demand job, PAYROLL to CA 7:

  - `zowe ca7 commands demand_1 --job PAYROLL`

### zowe › ca7 › commands › demandh

The DEMANDH command indicates that the demanded job is placed on hold in the CA Workload Automation CA 7® Edition request queue.

#### Usage

zowe ca7 commands demandh [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--job` (string)

  - Defines the name of the job being demanded.
    The demanded jobs are placed in the request queue and assigned a unique CA 7 job number.
    JOB and JOBL are mutually exclusive
    Limits:
    1 to 8 alphanumeric characters

- `--jobl` (string)

  - (Optional) Defines the long name of the job being demanded. The demanded jobs are placed in the request queue and assigned a unique CA 7 job number.
    JOB and JOBL are mutually exclusive
    Limits:
    1 to 64 alphanumeric characters

- `--arfset` (string)

  - (Optional)Defines the ARF set name that is used for this run of the job.
    you specify **NONE**, no ARF processing is performed for this run of the job
    Limits:
    1 to 4 alphanumeric characters

- `--cc` (string)

  - (Optional)Defines, with RO (relational operator), the job-level condition codes that are used to determine whether a job executes successfully.
    If specified, this value overrides the RO defined for the job in the CA WA CA 7 Edition database.
    RO is required when CC is specified
    Limits:
    1 to 4 numeric characters(0-4095)

- `--class` (string)

  - (Optional)Defines the workload balancing class for resource checking,
    Limits:
    1 alphanumeric character

- `--count` (string)

  - Defines the maximum number of times to repeat the job. COUNT is ignored if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating when the COUNT reaches zero or the STOP time is reached, whichever comes first.
    Default: None. The job continues repeating until the STOP time is reached
    Limits:
    1 to 4 numeric characters(0-1439)

- `--date` (string)

  - (Optional)Defines due-out and submit dates.
    Limits:
    If used, specify DOTM or TIME.
    +nn
    Defines the number of days after the current date.
    Limits:
    1 to 2 numeric characters from 1 to 99
    yyddd
    Defines the Julian date to run the job.

- `--depjob` (string)

  - (Optional)Defines a single predecessor job that must complete while the demanded job is waiting.
    Limits:
    1 to 8 alphanumeric characters

- `--dotm` (string)

  - (Optional)Defines the due-out time-of-day for the job in hours (hh) and minutes (mm).
    If omitted, the current time (when the DEMAND was processed) plus the lead time is assumed.
    If DOTM is specified on the DEMAND/DEMANDH command and the value that is given is earlier than the current time, the due-out day is assumed to be the following day.
    If DOTM and LEADTM are both omitted, then deadline start time is assumed to be the current time plus the LEADTM.
    Default: Current time, hhmm

- `--exec` (string)

  - (Optional)Specifies whether to execute the job (YES/NO).
    If NO (N) is used, the job does not run but shows a normal completion as if it did run.
    The value that is specified here overrides the value that is coded on the job definition EXEC field.
    Default: The job definition panel EXEC value if the job is defined to CA WA CA 7 Edition; otherwise YES,
    Values:YES|Y, NO|N

- `--interval` (string)

  - (Optional)Identifies that the job is repeated (executed more than once) and defines the amount of time between each iteration.
    If INTERVAL is specified, the TIME and TYPE keywords are required.
    If both INTERVAL and COUNT are specified, the INTERVAL value times the COUNT value must total less than 24 hours.
    For information about how the deadline, due-out, and submit times are calculated for repeating jobs, see the Usage Notes.
    Default: None. The job is not repeated.
    Limits:
    hh=1 through 2 numeric charact, hhmm

- `--jclid` (string)

  - (Optional)Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a numeric INDEX associated with the wanted JCL data set (on the JCL statement in the initialization file).
    If the job is defined in the database, the value must be the same as the value on the DB.1 panel
    or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLLIB field is required if the job is not defined in the database.
    JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed,

    Limits:
    1 to 3 numeric characters(1-999)

- `--jcllib` (string)

  - (Optional)Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a symbolic INDEX associated with the wanted JCL data set (on the JCL statement in the initialization file).
    If the job is defined in the database, the value must be the same as the value on the DB.1 panel
    or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLID field is required if the job is not defined in the database. JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed
    1 to 3 numeric characters from 0 through 254 and from 256 through 999. 255 is reserved.

- `--late` (string)

  - (Optional)Specifies whether a notification occurs when the job becomes late.
    Specify YES (Y) to make the job eligible to be marked LATE.
    If NO (N) is used, the job is never marked LATE.
    The value that is specified here overrides the value that is coded on the job definition PROMPTS field,
    Values:YES|Y, NO|N

- `--leadtm` (string)

  - (Optional)Defines the amount of elapsed time that is required to process the job.
    Indicates in hours (hh) and minutes (mm) the elapsed time.
    The maximum value that you can specify is 2400.
    Default: 1 hour
    Limits:
    hh= 1 through 2 numeric characters from 0 to 24
    mm= 2 numeric characters from 00 to 59

- `--mainid` (string)

  - (Optional)Specifies the MAINID, as defined in the initialization file CPU statement, to which you want to redirect the job.
    The value that is specified here overrides the value that is coded on the job definition MAINID field.
    Also, the SASSXX05 user exit does not override this value.
    The name must be one of the following values: ALL Specifies all CPUs are acceptable for executing the job.
    SYn n defines the CPU to which the job is being redirected. The value of n can range from 1 to 7.
    /SYn n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.
    -SYn n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.
    Limits:
    Invalid for internal cross-platform jobs.

- `--prty` (string)

  - (Optional)Defines the initial workload balancing priority,
    1-3 numeric (1-255)

- `--rms` (string)

  - (Optional)Specifies whether CA WA CA 7 Edition inserts the CA Workload Automation Restart_XXX Option for z/OS Schedulers RMS step.
    Specify YES (Y) to insert the step with the CA Workload Automation Restart_XXX Option for z/OS Schedulers processing code of P.Enter NO (N) to indicate do not insert of the RMS step.
    The value that is specified here overrides the value that is coded on the job definition INSERT-RMS field.
    Default: The job definition panel INSERT-RMS value if job defined to CA WA CA 7 Edition; otherwise NO.
    Limits:
    Invalid for internal cross-platform jobs
    , Values: YES|Y, NO|N

- `--ro` (string)

  - (Optional)Specifies the relational operator of the condition code (CC) or
    if the step level #SCC statements are being used in the JCL of the job.
    If specified, this RO overrides the RO defined for the job in the CA WA CA 7 Edition database.
    The following values are valid:
    EQ : Equal to
    LT : Less than
    GT : Greater than
    GE : Greater than or equal to
    LE : Less than or equal to
    NE : Not equal to
    #S : Step condition code tests to be made based on a #SCC statement.
    IG : No evaluation of the job is done.
    CA WA CA 7 Edition always assumes that the job completes successfully, regardless of condition codes, abend codes, or run-time JCL errors.
    0: No condition code test is made.
    Default: The job definition panel RO value if the job is defined to CA WA CA 7 Edition; otherwise 0.
    Limits:

    Invalid with agent jobs.

- `--schid` (string)

  - Defines the schedule ID within the job's total schedule definition to use for this run.
    If omitted, SCHID=1 is assumed unless the job exists in the CA WA CA 7 Edition database and has an associated schedule.
    In this case, the first SCHID defined in the schedule member is assumed.
    Default: 1,
    Limits:
    1 to 3 numeric characters from 1 to 999 (See Note)
    Note: If the SCHEDULE statement in the initialization file specifies SCHID=YES, this parameter is required.

- `--set` (string)

  - (Optional)Specifies skip the next scheduled cycle for the job (SKP),
    disable triggering (NTR), or bypass the database updating at the job completion.
    SKP
    Specifies this run of the job takes the place of the next scheduled run.
    This value has the same effect as entering NXTCYC,SET=SKP.
    It is reflected on output from LJOB and LLOCK commands as if NXTCYC,SET=SKP was used.
    This parameter is invalid if the job has no schedule.
    SET=SKP has no impact on repeating jobs that are already in the queues.
    NTR Specifies normal triggering is disabled only for this run of the job.
    NDB Allows a job to bypass all load processing at the job completion,
    but allows other processing to proceed typically.
    Note: Data set triggering is still in effect.
    , SKP|NTR|NDB

- `--stop` (string)

  - (Optional)Defines the clock time after which the job is not repeated.
    STOP is ignored if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating when either the COUNT reaches zero or the STOP time is reached, whichever comes first.
    If the STOP time is less than the submit time, the stop date is assumed to be the following day.
    Default:
    1439 minutes (24 hours minus 1 minute) after the submit time
    Limits:

    hh=1 through 2 numeric characters from 0 to 23
    mm=2 numeric characters from 00 to 59

- `--time` (string)

  - (Optional)Defines a submit time-of-day requirement for the job.
    If the format is used with a +, the submit time is calculated from the current time, adding the specified number of hours and minutes.
    If the + is used, the DATE keyword must be omitted.
    Limits:

    + is optional
    hh= 1 through 2 numeric characters from 0 to 23
    mm= 2 numeric characters from 00 to 59
    Required:

    No (unless DATE is used, if so, specify DOTM or TIME (hhmm format). Also required if TYPE=CLOCK is specified.

- `--type` (string)

  - (Optional)TYPE=RES specifies the job is being scheduled in restart/rerun status.
    TYPE=CLOCK, START, or END controls how the submit time requirement is calculated for repeating jobs.

    When TYPE=RES the job is put into the request queue with a restart requirement.
    The job is not submitted before the CA WA CA 7 Edition restart is done.
    The output networks are scheduled, but input requirements checking is bypassed.
    TYPE=CLOCK, START, or END is ignored if INTERVAL is not specified.
    With TYPE=CLOCK, the interval is added to the previous iteration's submit time requirement to determine the new submit time requirement.
    With TYPE=START and END the interval is added to the previous iteration's last (most recent) start and end time,
    respectively, to determine the new submit time requirement. TYPE is required when INTERVAL is specified.
    Limits:

    RES, CLOCK, START, or END

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Hold the demanded job PAYROLL to CA 7 on Instance1:

  - `zowe ca7 commands demandh --ca7Id Instance1 --job PAYROLL`

### zowe › ca7 › commands › demandh › 1

The DEMANDH command indicates that the demanded job is placed on hold in the CA Workload Automation CA 7® Edition request queue.

#### Usage

zowe ca7 commands demandh_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--job` (string)

  - Defines the name of the job being demanded.
    The demanded jobs are placed in the request queue and assigned a unique CA 7 job number.
    JOB and JOBL are mutually exclusive
    Limits:
    1 to 8 alphanumeric characters

- `--jobl` (string)

  - (Optional) Defines the long name of the job being demanded. The demanded jobs are placed in the request queue and assigned a unique CA 7 job number.
    JOB and JOBL are mutually exclusive
    Limits:
    1 to 64 alphanumeric characters

- `--arfset` (string)

  - (Optional)Defines the ARF set name that is used for this run of the job.
    you specify **NONE**, no ARF processing is performed for this run of the job
    Limits:
    1 to 4 alphanumeric characters

- `--cc` (string)

  - (Optional)Defines, with RO (relational operator), the job-level condition codes that are used to determine whether a job executes successfully.
    If specified, this value overrides the RO defined for the job in the CA WA CA 7 Edition database.
    RO is required when CC is specified
    Limits:
    1 to 4 numeric characters(0-4095)

- `--class` (string)

  - (Optional)Defines the workload balancing class for resource checking,
    Limits:
    1 alphanumeric character

- `--count` (string)

  - Defines the maximum number of times to repeat the job. COUNT is ignored if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating when the COUNT reaches zero or the STOP time is reached, whichever comes first.
    Default: None. The job continues repeating until the STOP time is reached
    Limits:
    1 to 4 numeric characters(0-1439)

- `--date` (string)

  - (Optional)Defines due-out and submit dates.
    Limits:
    If used, specify DOTM or TIME.
    +nn
    Defines the number of days after the current date.
    Limits:
    1 to 2 numeric characters from 1 to 99
    yyddd
    Defines the Julian date to run the job.

- `--depjob` (string)

  - (Optional)Defines a single predecessor job that must complete while the demanded job is waiting.
    Limits:
    1 to 8 alphanumeric characters

- `--dotm` (string)

  - (Optional)Defines the due-out time-of-day for the job in hours (hh) and minutes (mm).
    If omitted, the current time (when the DEMAND was processed) plus the lead time is assumed.
    If DOTM is specified on the DEMAND/DEMANDH command and the value that is given is earlier than the current time, the due-out day is assumed to be the following day.
    If DOTM and LEADTM are both omitted, then deadline start time is assumed to be the current time plus the LEADTM.
    Default: Current time, hhmm

- `--exec` (string)

  - (Optional)Specifies whether to execute the job (YES/NO).
    If NO (N) is used, the job does not run but shows a normal completion as if it did run.
    The value that is specified here overrides the value that is coded on the job definition EXEC field.
    Default: The job definition panel EXEC value if the job is defined to CA WA CA 7 Edition; otherwise YES,
    Values:YES|Y, NO|N

- `--interval` (string)

  - (Optional)Identifies that the job is repeated (executed more than once) and defines the amount of time between each iteration.
    If INTERVAL is specified, the TIME and TYPE keywords are required.
    If both INTERVAL and COUNT are specified, the INTERVAL value times the COUNT value must total less than 24 hours.
    For information about how the deadline, due-out, and submit times are calculated for repeating jobs, see the Usage Notes.
    Default: None. The job is not repeated.
    Limits:
    hh=1 through 2 numeric charact, hhmm

- `--jclid` (string)

  - (Optional)Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a numeric INDEX associated with the wanted JCL data set (on the JCL statement in the initialization file).
    If the job is defined in the database, the value must be the same as the value on the DB.1 panel
    or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLLIB field is required if the job is not defined in the database.
    JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed,

    Limits:
    1 to 3 numeric characters(1-999)

- `--jcllib` (string)

  - (Optional)Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a symbolic INDEX associated with the wanted JCL data set (on the JCL statement in the initialization file).
    If the job is defined in the database, the value must be the same as the value on the DB.1 panel
    or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLID field is required if the job is not defined in the database. JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed
    1 to 3 numeric characters from 0 through 254 and from 256 through 999. 255 is reserved.

- `--late` (string)

  - (Optional)Specifies whether a notification occurs when the job becomes late.
    Specify YES (Y) to make the job eligible to be marked LATE.
    If NO (N) is used, the job is never marked LATE.
    The value that is specified here overrides the value that is coded on the job definition PROMPTS field,
    Values:YES|Y, NO|N

- `--leadtm` (string)

  - (Optional)Defines the amount of elapsed time that is required to process the job.
    Indicates in hours (hh) and minutes (mm) the elapsed time.
    The maximum value that you can specify is 2400.
    Default: 1 hour
    Limits:
    hh= 1 through 2 numeric characters from 0 to 24
    mm= 2 numeric characters from 00 to 59

- `--mainid` (string)

  - (Optional)Specifies the MAINID, as defined in the initialization file CPU statement, to which you want to redirect the job.
    The value that is specified here overrides the value that is coded on the job definition MAINID field.
    Also, the SASSXX05 user exit does not override this value.
    The name must be one of the following values: ALL Specifies all CPUs are acceptable for executing the job.
    SYn n defines the CPU to which the job is being redirected. The value of n can range from 1 to 7.
    /SYn n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.
    -SYn n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.
    Limits:
    Invalid for internal cross-platform jobs.

- `--prty` (string)

  - (Optional)Defines the initial workload balancing priority,
    1-3 numeric (1-255)

- `--rms` (string)

  - (Optional)Specifies whether CA WA CA 7 Edition inserts the CA Workload Automation Restart_XXX Option for z/OS Schedulers RMS step.
    Specify YES (Y) to insert the step with the CA Workload Automation Restart_XXX Option for z/OS Schedulers processing code of P.Enter NO (N) to indicate do not insert of the RMS step.
    The value that is specified here overrides the value that is coded on the job definition INSERT-RMS field.
    Default: The job definition panel INSERT-RMS value if job defined to CA WA CA 7 Edition; otherwise NO.
    Limits:
    Invalid for internal cross-platform jobs
    , Values: YES|Y, NO|N

- `--ro` (string)

  - (Optional)Specifies the relational operator of the condition code (CC) or
    if the step level #SCC statements are being used in the JCL of the job.
    If specified, this RO overrides the RO defined for the job in the CA WA CA 7 Edition database.
    The following values are valid:
    EQ : Equal to
    LT : Less than
    GT : Greater than
    GE : Greater than or equal to
    LE : Less than or equal to
    NE : Not equal to
    #S : Step condition code tests to be made based on a #SCC statement.
    IG : No evaluation of the job is done.
    CA WA CA 7 Edition always assumes that the job completes successfully, regardless of condition codes, abend codes, or run-time JCL errors.
    0: No condition code test is made.
    Default: The job definition panel RO value if the job is defined to CA WA CA 7 Edition; otherwise 0.
    Limits:

    Invalid with agent jobs.

- `--schid` (string)

  - Defines the schedule ID within the job's total schedule definition to use for this run.
    If omitted, SCHID=1 is assumed unless the job exists in the CA WA CA 7 Edition database and has an associated schedule.
    In this case, the first SCHID defined in the schedule member is assumed.
    Default: 1,
    Limits:
    1 to 3 numeric characters from 1 to 999 (See Note)
    Note: If the SCHEDULE statement in the initialization file specifies SCHID=YES, this parameter is required.

- `--set` (string)

  - (Optional)Specifies skip the next scheduled cycle for the job (SKP),
    disable triggering (NTR), or bypass the database updating at the job completion.
    SKP
    Specifies this run of the job takes the place of the next scheduled run.
    This value has the same effect as entering NXTCYC,SET=SKP.
    It is reflected on output from LJOB and LLOCK commands as if NXTCYC,SET=SKP was used.
    This parameter is invalid if the job has no schedule.
    SET=SKP has no impact on repeating jobs that are already in the queues.
    NTR Specifies normal triggering is disabled only for this run of the job.
    NDB Allows a job to bypass all load processing at the job completion,
    but allows other processing to proceed typically.
    Note: Data set triggering is still in effect.
    , SKP|NTR|NDB

- `--stop` (string)

  - (Optional)Defines the clock time after which the job is not repeated.
    STOP is ignored if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating when either the COUNT reaches zero or the STOP time is reached, whichever comes first.
    If the STOP time is less than the submit time, the stop date is assumed to be the following day.
    Default:
    1439 minutes (24 hours minus 1 minute) after the submit time
    Limits:

    hh=1 through 2 numeric characters from 0 to 23
    mm=2 numeric characters from 00 to 59

- `--time` (string)

  - (Optional)Defines a submit time-of-day requirement for the job.
    If the format is used with a +, the submit time is calculated from the current time, adding the specified number of hours and minutes.
    If the + is used, the DATE keyword must be omitted.
    Limits:

    + is optional
    hh= 1 through 2 numeric characters from 0 to 23
    mm= 2 numeric characters from 00 to 59
    Required:

    No (unless DATE is used, if so, specify DOTM or TIME (hhmm format). Also required if TYPE=CLOCK is specified.

- `--type` (string)

  - (Optional)TYPE=RES specifies the job is being scheduled in restart/rerun status.
    TYPE=CLOCK, START, or END controls how the submit time requirement is calculated for repeating jobs.

    When TYPE=RES the job is put into the request queue with a restart requirement.
    The job is not submitted before the CA WA CA 7 Edition restart is done.
    The output networks are scheduled, but input requirements checking is bypassed.
    TYPE=CLOCK, START, or END is ignored if INTERVAL is not specified.
    With TYPE=CLOCK, the interval is added to the previous iteration's submit time requirement to determine the new submit time requirement.
    With TYPE=START and END the interval is added to the previous iteration's last (most recent) start and end time,
    respectively, to determine the new submit time requirement. TYPE is required when INTERVAL is specified.
    Limits:

    RES, CLOCK, START, or END

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Hold the demanded job PAYROLL to CA 7 on Instance1:

  - `zowe ca7 commands demandh_1 --ca7Id Instance1 --job PAYROLL`

### zowe › ca7 › commands › hold

The HOLD command interrupts the normal scheduling progress by holding the forward movement of a job.
The command can also hold the contents of an entire queue.
This function is available on the QM.1 panel with a FILL value of H.
Depending on the timing and whether you have any other predecessor situations, the QM.3 panel can sometimes accomplish this process.

#### Usage

zowe ca7 commands hold [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Defines the individual job number to hold. Omit if Q is specified.
    jobnumber
    Defines the job number of the job to hold.
    Limits:
    1 to 4 numeric characters
    Required: Yes, unless the Q parameter is used.

- `-q` (string)

  - Specifies to hold the contents of an entire queue.
    Possible values:
    REQ
    Specifies to hold all jobs currently in the request queue. RDY
    Specifies to hold all jobs currently in the ready queue.Required: Yes, unless job number is used.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Hold the CA7 number 29 on Instance1:

  - `zowe ca7 commands hold --ca7Id Instance1 --ca7# 29`

### zowe › ca7 › commands › hold › 1

The HOLD command interrupts the normal scheduling progress by holding the forward movement of a job.
The command can also hold the contents of an entire queue.
This function is available on the QM.1 panel with a FILL value of H.
Depending on the timing and whether you have any other predecessor situations, the QM.3 panel can sometimes accomplish this process.

#### Usage

zowe ca7 commands hold_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Defines the individual job number to hold. Omit if Q is specified.
    jobnumber
    Defines the job number of the job to hold.
    Limits:
    1 to 4 numeric characters
    Required: Yes, unless the Q parameter is used.

- `-q` (string)

  - Specifies to hold the contents of an entire queue.
    Possible values:
    REQ
    Specifies to hold all jobs currently in the request queue. RDY
    Specifies to hold all jobs currently in the ready queue.Required: Yes, unless job number is used.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Hold the CA7 number 29:

  - `zowe ca7 commands hold_1 --ca7# 29`

### zowe › ca7 › commands › jclovrd

The JCLOVRD command establishes or satisfies JCL override requirements.
This command is primarily used when the CPU job does not have a permanent JCL override requirement assigned.
The CPU job for which the JCL override is being established (or satisfied) must be in the request queue.
If you are using CA Workload Automation CA 7 Edition to insert IBM WLM scheduling environment keywords on JOB statements,
you can use the JCLOVRD command to suppress or allow SCHENV= keyword insertion.
This function is available as the J value for FILL FUNCTION on the QM.1 panel.
The function can also be accomplished with the QM.2 and QM.3 panels.

#### Usage

zowe ca7 commands jclovrd [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Defines the CA 7 job number of the job in the request queue for which to establish or remove the override requirement.
    Limits:
    1 to 4 numeric characters

- `--set` (string)

  - Specifies to establish or satisfy JCL override requirements.
    When a job fails with a JCL error, the JCL override requirement is automatically set to ON when the job returns to the request queue.
    The JCL override must be set to OFF before the job can be submitted again.
    ON
    Establishes a JCL override requirement for the specified job.
    The SET=ON option is used for jobs in the request queue to indicate that an override is needed before execution is to occur.
    OFF
    Satisfies a JCL override requirement for the specified job. The SET=OFF option indicates that a previously defined need (requirement) for overrides has been satisfied and execution can be safely attempted.
    When a JCL override requirement is set to OFF,
    that requirement no longer appears on a requirements list for the job
    When a REPL is done from the QM.5 panel, the JCL override requirement is automatically set to OFF.
    WLM
    Sets job to allow the insertion of SCHENV= keyword on the JOB statement at submission time when these conditions are true:
    The scheduling environment insertion feature is activated.
    A scheduling Environment VRM definition is attached to the job (or SCHENV global default).
    NOWLM
    Sets job to suppress the insertion of a SCHENV= keyword on the JOB statement at submission time even when one is typically associated with the job.
    This option can be used when the validation of an associated IBM WLM scheduling environment has failed causing the job to be requeued (see Browse message SSM0-42).
    FSetting the NOWLM option lets you submit the job without SCHENV= keyword insertion.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Establishes or satisfies JCL override requirements for CA7 number 29 on Instance1:

  - `zowe ca7 commands jclovrd --ca7Id Instance1 --ca7# 29`

### zowe › ca7 › commands › jclovrd › 1

The JCLOVRD command establishes or satisfies JCL override requirements.
This command is primarily used when the CPU job does not have a permanent JCL override requirement assigned.
The CPU job for which the JCL override is being established (or satisfied) must be in the request queue.
If you are using CA Workload Automation CA 7 Edition to insert IBM WLM scheduling environment keywords on JOB statements,
you can use the JCLOVRD command to suppress or allow SCHENV= keyword insertion.
This function is available as the J value for FILL FUNCTION on the QM.1 panel.
The function can also be accomplished with the QM.2 and QM.3 panels.

#### Usage

zowe ca7 commands jclovrd_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Defines the CA 7 job number of the job in the request queue for which to establish or remove the override requirement.
    Limits:
    1 to 4 numeric characters

- `--set` (string)

  - Specifies to establish or satisfy JCL override requirements.
    When a job fails with a JCL error, the JCL override requirement is automatically set to ON when the job returns to the request queue.
    The JCL override must be set to OFF before the job can be submitted again.
    ON
    Establishes a JCL override requirement for the specified job.
    The SET=ON option is used for jobs in the request queue to indicate that an override is needed before execution is to occur.
    OFF
    Satisfies a JCL override requirement for the specified job. The SET=OFF option indicates that a previously defined need (requirement) for overrides has been satisfied and execution can be safely attempted.
    When a JCL override requirement is set to OFF,
    that requirement no longer appears on a requirements list for the job
    When a REPL is done from the QM.5 panel, the JCL override requirement is automatically set to OFF.
    WLM
    Sets job to allow the insertion of SCHENV= keyword on the JOB statement at submission time when these conditions are true:
    The scheduling environment insertion feature is activated.
    A scheduling Environment VRM definition is attached to the job (or SCHENV global default).
    NOWLM
    Sets job to suppress the insertion of a SCHENV= keyword on the JOB statement at submission time even when one is typically associated with the job.
    This option can be used when the validation of an associated IBM WLM scheduling environment has failed causing the job to be requeued (see Browse message SSM0-42).
    FSetting the NOWLM option lets you submit the job without SCHENV= keyword insertion.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Establishes or satisfies JCL override requirements for CA7 number 29:

  - `zowe ca7 commands jclovrd_1 --ca7# 29`

### zowe › ca7 › commands › post

The POST command indicates to the CA Workload Automation CA 7 Edition
system that a preexecution requirement for a job in the request queue is satisfied.
Two categories of requirements can be satisfied, internal and external.
The internal requirements are known within the database and CA WA CA 7 Edition controls them.
An example of an internal requirement is the completion of another job that CA WA CA 7 Edition
controls whose completion satisfies a requirement for a dependent job.
The external requirements are defined in the database but not controlled by CA WA CA 7 Edition.
A manual post must satisfy external requirements unless the requirement is cataloged in the CA WA CA 7 Edition
catalog before the using job is scheduled into the request queue.
This function is available through the QM.2 CPU Job Predecessors Prompt panel.

#### Usage

zowe ca7 commands post [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Indicates the job number in up to four digits, for which requirements are posted.

- `--usr` (string)

  - (Optional) Identifies a user-defined description of a requirement to post as satisfied.
    Mutually exclusive with DEPJOB and DSN.
    When used, must match the text that is used to define the requirement on the DB.6 panel or with the ADDRQ command.
    Limits:
    1 to 36 alphanumeric characters

- `--depjob` (string)

  - (Optional) Identifies a predecessor job dependency requirement to post as satisfied.
    Value must be a specific job name.
    Mutually exclusive with DSN and USR.
    In normal situations, CA WA CA 7 Edition automatically posts this type of requirement when the predecessor job completes its execution successfully.
    A manual posting is only necessary if a job defined as a requirement was not to be run,
    or ran unsuccessfully and a successor job is to be run.The DEPJOB must be posted if it is not currently defined to CA WA CA 7 Edition
    (an external job).
    Limits:
    1 to 8 alphanumeric characters

- `--dsn` (string)

  - (Optional) Identifies a data set requirement to post as satisfied.
    Value can be a specific data set name or a CA WA CA 7 Edition data set number.
    If you are using a number, only the number can be specified without the DS prefix.
    Mutually exclusive with DEPJOB and USR.
    dsname
    Indicates a specific data set name.
    Limits:
    1 to 44 alphanumeric characters
    dsnumber
    Indicates a specific data set number. Limits:
    1 to 8 numeric characters

- `--internal` (string)

  - (Optional) Valid only with DSN to indicate that the data set being posted is internal to the CA WA CA 7 Edition workload.
    YES is the only acceptable value.
    Mutually exclusive with USR, DEPJOB, and PREQ.
    In normal situations, CA WA CA 7 Edition automatically posts requirements for internal data sets.
    Limits:
    YES is the only acceptable value.

- `--preq` (string)

  - (Optional) Valid only with DSN to identify up to 11 numeric values to include
    with other CA WA CA 7 Edition log data logged as a result of the POST command being issued.
    Mutually exclusive with USR, DEPJOB, and INTERNAL.
    Code values in sublist form, within parentheses.
    You can code up to 11 values that are separated by commas between the parentheses.
    Each value cannot exceed 4 numeric digits.
    This optional field can be useful for logging any meaningful numbers, such as batch numbers, which can later be reviewed in the log data set.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- The requirement for ca7 number 0016 in the request queue is satisfied on Instance1:

  - `zowe ca7 commands post --ca7Id Instance1 --ca7# 0016`

### zowe › ca7 › commands › post › 1

The POST command indicates to the CA Workload Automation CA 7 Edition
system that a preexecution requirement for a job in the request queue is satisfied.
Two categories of requirements can be satisfied, internal and external.
The internal requirements are known within the database and CA WA CA 7 Edition controls them.
An example of an internal requirement is the completion of another job that CA WA CA 7 Edition
controls whose completion satisfies a requirement for a dependent job.
The external requirements are defined in the database but not controlled by CA WA CA 7 Edition.
A manual post must satisfy external requirements unless the requirement is cataloged in the CA WA CA 7 Edition
catalog before the using job is scheduled into the request queue.
This function is available through the QM.2 CPU Job Predecessors Prompt panel.

#### Usage

zowe ca7 commands post_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Indicates the job number in up to four digits, for which requirements are posted.

- `--usr` (string)

  - (Optional) Identifies a user-defined description of a requirement to post as satisfied.
    Mutually exclusive with DEPJOB and DSN.
    When used, must match the text that is used to define the requirement on the DB.6 panel or with the ADDRQ command.
    Limits:
    1 to 36 alphanumeric characters

- `--depjob` (string)

  - (Optional) Identifies a predecessor job dependency requirement to post as satisfied.
    Value must be a specific job name.
    Mutually exclusive with DSN and USR.
    In normal situations, CA WA CA 7 Edition automatically posts this type of requirement when the predecessor job completes its execution successfully.
    A manual posting is only necessary if a job defined as a requirement was not to be run,
    or ran unsuccessfully and a successor job is to be run.The DEPJOB must be posted if it is not currently defined to CA WA CA 7 Edition
    (an external job).
    Limits:
    1 to 8 alphanumeric characters

- `--dsn` (string)

  - (Optional) Identifies a data set requirement to post as satisfied.
    Value can be a specific data set name or a CA WA CA 7 Edition data set number.
    If you are using a number, only the number can be specified without the DS prefix.
    Mutually exclusive with DEPJOB and USR.
    dsname
    Indicates a specific data set name.
    Limits:
    1 to 44 alphanumeric characters
    dsnumber
    Indicates a specific data set number. Limits:
    1 to 8 numeric characters

- `--internal` (string)

  - (Optional) Valid only with DSN to indicate that the data set being posted is internal to the CA WA CA 7 Edition workload.
    YES is the only acceptable value.
    Mutually exclusive with USR, DEPJOB, and PREQ.
    In normal situations, CA WA CA 7 Edition automatically posts requirements for internal data sets.
    Limits:
    YES is the only acceptable value.

- `--preq` (string)

  - (Optional) Valid only with DSN to identify up to 11 numeric values to include
    with other CA WA CA 7 Edition log data logged as a result of the POST command being issued.
    Mutually exclusive with USR, DEPJOB, and INTERNAL.
    Code values in sublist form, within parentheses.
    You can code up to 11 values that are separated by commas between the parentheses.
    Each value cannot exceed 4 numeric digits.
    This optional field can be useful for logging any meaningful numbers, such as batch numbers, which can later be reviewed in the log data set.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- The requirement for ca7 number 0016 in the request queue is satisfied::

  - `zowe ca7 commands post_1 --ca7# 0016`

### zowe › ca7 › commands › prscf

The PRSCF command frees a shared, exclusive, or RCT resource that is connected to a job that:

Is executing
Is in ABEND status in the request queue
Has already executed and purged from the request queue
PRSCF can also remove a virtual resource from consideration of a job currently in the active workload and waiting to execute.

#### Usage

zowe ca7 commands prscf [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--job` (string)

  - Specifies the CA Workload Automation CA 7 Edition job name or number to which the resource is attached.
    jobnumber
    Indicates a specific CA 7 job number.
    Limits:
    1 to 4 numeric characters

- `--rsrc` (string)

  - Specifies the fully qualified resource name to free.
    You can optionally specify * to indicate to free all resources that are connected to the job.
    Limits:
    1 to 44 alphanumeric characters

- `--force` (string)

  - (Optional) FORCE=YES indicates that CA WA CA 7 Edition is not to evaluate
    the availability of the named resources for this run of the job only.
    This run of the job does not use the named resources.
    This keyword can be used on an exception basis to let a job in a W-RSRC status bypass VRM checking for one or more resources defined for it on the RM.1 panel.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Frees resources for Job PAYROLL on Instance1:

  - `zowe ca7 commands prscf --ca7Id Instance1 --job PAYROLL`

### zowe › ca7 › commands › prscf › 1

The PRSCF command frees a shared, exclusive, or RCT resource that is connected to a job that:

Is executing
Is in ABEND status in the request queue
Has already executed and purged from the request queue
PRSCF can also remove a virtual resource from consideration of a job currently in the active workload and waiting to execute.

#### Usage

zowe ca7 commands prscf_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--job` (string)

  - Specifies the CA Workload Automation CA 7 Edition job name or number to which the resource is attached.
    jobnumber
    Indicates a specific CA 7 job number.
    Limits:
    1 to 4 numeric characters

- `--rsrc` (string)

  - Specifies the fully qualified resource name to free.
    You can optionally specify * to indicate to free all resources that are connected to the job.
    Limits:
    1 to 44 alphanumeric characters

- `--force` (string)

  - (Optional) FORCE=YES indicates that CA WA CA 7 Edition is not to evaluate
    the availability of the named resources for this run of the job only.
    This run of the job does not use the named resources.
    This keyword can be used on an exception basis to let a job in a W-RSRC status bypass VRM checking for one or more resources defined for it on the RM.1 panel.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Frees resources for Job PAYROLL:

  - `zowe ca7 commands prscf_1 --job PAYROLL`

### zowe › ca7 › commands › prsqa

The PRSQA command activates a corequisite resource.
When a job is connected to a corequisite resource and the resource usage type is active, use the PRSQA command to activate the corequisite resource.

If VRM corequisite propagation is enabled and the resource name matches the propagation prefix,
the command is forwarded to the CA 7 instances that are specified in the initialization file options unless INTERNAL=YES is specified.
Command propagation is honored even if the resource is already active.

#### Usage

zowe ca7 commands prsqa [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--rsrc` (string)

  - Specifies a fully qualified corequisite resource name.
    Limits:
    1 to 44 alphanumeric characters

- `--internal` (string)

  - (Optional) If YES or Y is specified, the command is not forwarded to other CA 7 instances
    even if VRM Corequisite Propagation is enabled and the resource name matches the selection criteria.
    Default: NO

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Activated the resource CICSREG8 for Instance1:

  - `zowe ca7 commands prsqa --rsrc CICSREG8 --ca7Id Instance1`

### zowe › ca7 › commands › prsqa › 1

The PRSQA command activates a corequisite resource.
When a job is connected to a corequisite resource and the resource usage type is active, use the PRSQA command to activate the corequisite resource.

If VRM corequisite propagation is enabled and the resource name matches the propagation prefix,
the command is forwarded to the CA 7 instances that are specified in the initialization file options unless INTERNAL=YES is specified.
Command propagation is honored even if the resource is already active.

#### Usage

zowe ca7 commands prsqa_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--rsrc` (string)

  - Specifies a fully qualified corequisite resource name.
    Limits:
    1 to 44 alphanumeric characters

- `--internal` (string)

  - (Optional) If YES or Y is specified, the command is not forwarded to other CA 7 instances
    even if VRM Corequisite Propagation is enabled and the resource name matches the selection criteria.
    Default: NO

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Activated the resource CICSREG8:

  - `zowe ca7 commands prsqa_1 --rsrc CICSREG8`

### zowe › ca7 › commands › prsqd

The PRSQD command deactivates a corequisite resource that a PRSQA command activated. This command is the only way to deactivate a corequisite resource.

If VRM corequisite propagation is enabled and the resource name matches the propagation prefix, the command is forwarded to the CA 7 instances that are specified in the initialization file options unless INTERNAL=YES is specified.
Command propagation is honored even if the resource is already active.

#### Usage

zowe ca7 commands prsqd [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--rsrc` (string)

  - Specifies a fully qualified corequisite resource name.
    Limits:
    1 to 44 alphanumeric characters

- `--internal` (string)

  - (Optional) If YES or Y is specified, the command is not forwarded to other CA 7 instances
    even if VRM Corequisite Propagation is enabled and the resource name matches the selection criteria.
    Default: NO

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deactivate the resource CICSREG8 for Instance1:

  - `zowe ca7 commands prsqd --rsrc CICSREG8 --ca7Id Instance1`

### zowe › ca7 › commands › prsqd › 1

The PRSQD command deactivates a corequisite resource that a PRSQA command activated. This command is the only way to deactivate a corequisite resource.

If VRM corequisite propagation is enabled and the resource name matches the propagation prefix, the command is forwarded to the CA 7 instances that are specified in the initialization file options unless INTERNAL=YES is specified.
Command propagation is honored even if the resource is already active.

#### Usage

zowe ca7 commands prsqd_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--rsrc` (string)

  - Specifies a fully qualified corequisite resource name.
    Limits:
    1 to 44 alphanumeric characters

- `--internal` (string)

  - (Optional) If YES or Y is specified, the command is not forwarded to other CA 7 instances
    even if VRM Corequisite Propagation is enabled and the resource name matches the selection criteria.
    Default: NO

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deactivate the resource CICSREG8 for Instance1:

  - `zowe ca7 commands prsqd_1 --rsrc CICSREG8 --ca7Id Instance1`

### zowe › ca7 › commands › release

The RELEASE top line command indicates that normal scheduling activities can now be resumed for jobs or queues on HOLD.

#### Usage

zowe ca7 commands release [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Indicates the individual job to release, and the value must be a CA 7 job number.
    Omit jobnumber when Q is specified.

- `-q` (string)

  - Indicates to release the contents of an entire queue. Omit Q when JOB or JOBL is specified.Required:
    Yes, unless JOB or JOBL is used. Possible values: REQ
    Release_XXX the contents of the request queue.RDY
    Release_XXX the contents of the ready queue..

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Releases top line command for ca7 number 0016 from CA 7 on Instance1:

  - `zowe ca7 commands release --ca7# 0016 --ca7Id Instance1`

### zowe › ca7 › commands › release › 1

The RELEASE top line command indicates that normal scheduling activities can now be resumed for jobs or queues on HOLD.

#### Usage

zowe ca7 commands release_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Indicates the individual job to release, and the value must be a CA 7 job number.
    Omit jobnumber when Q is specified.

- `-q` (string)

  - Indicates to release the contents of an entire queue. Omit Q when JOB or JOBL is specified.Required:
    Yes, unless JOB or JOBL is used. Possible values: REQ
    Release_XXX the contents of the request queue.RDY
    Release_XXX the contents of the ready queue..

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Releases top line command for ca7 number 0016 from CA 7:

  - `zowe ca7 commands release_1 --ca7# 0016`

### zowe › ca7 › commands › requeue

The REQUEUE top line command moves jobs from the ready or active queues back to the request queue.
This command allows the use of the CA Workload Automation CA 7 Edition job restart facilities
after certain JCL, CPU, or node/agent failures, or job cancellation out of a CPU through the OS console.
This function is available as the Q option in the QM.1 CPU Jobs Status Prompt panel.

#### Usage

zowe ca7 commands requeue [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--agent` (string)

  - (Optional) Indicates the agent name or mask that an agent name must match for an agent job
    before it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    AGENT cannot be used with CPU, MAINID, or NODE.
    For any agent job that is requeued, a cancel request is sent to the agent running the job.
    The status of the agent or the computer on which the agent is running determines whether the request is honored.
    Limits:
    1 to 16 alphanumeric charactersDefault:
    * (all agent names)

- `--cpu` (string)

  - (Optional) Used with JOB to specify the CPU ID of active queue jobs that are to be requeued.
    The value identifies the CPU and corresponds to the CPU field displayed on the LQ command (the SMF identifier).
    CPU cannot be used with MAINID, NODE, or AGENT.
    The CPU parameter is ignored if used with a JOB parameter that references a specific job name or job number, but not if a job mask is specified.
    Limits:
    1 to 4 numeric characters

- `--force` (string)

  - (Optional) Resumes job completion for stranded jobs.
    When a job finishes executing, it must move to the request queue so that CA WA CA 7 Edition
    can process the database and queue updates that are required for job completion.
    But, if a job cannot be moved because of an I/O error or an out-of-space condition on the request queue,
    the job may be stranded in the ready or active queue, unable to complete
    Once the request queue error is corrected, you can use REQUEUE with FORCE=CMP to resume job completion for these jobs.
    Limits:
    CMP is the only value

- `--ca7#` (string)

  - (Optional) Indicates the job number
    must match before it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    If JOB is used alone, both the active and ready queues are searched for the specified job number.
    If JOB is used with Q, the search is restricted to the indicated queue. jobname,jobnumber and longjobname are mutually exclusive
    Default:
    * (all jobs)Limits:
    1 to 8 alphanumeric characters

- `--jobname` | `--jn` (string)

  - (Optional) Indicates the job name, or mask that a job name
    must match before it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    If JOB is used alone, both the active and ready queues are searched for the specified job.
    If JOB is used with Q, the search is restricted to the indicated queue. jobname,jobnumber and longjobname are mutually exclusive.
    Default:
    * (all jobs)Limits:
    1 to 8 alphanumeric characters

- `--longjobname` | `--lon` (string)

  - (Optional) Indicates the long job name or mask that a long job name must match before
    it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    If JOBL is used alone, both the active and ready queues are searched for the specified long job name.
    If JOBL is used with Q, the search is restricted to the indicated queue.jobname,jobnumber and longjobname are mutually exclusive
    Limits:
    1 to 64 alphanumeric characters

- `--mainid` (string)

  - (Optional) Used with JOB to indicate that only those jobs in the ready queue with this MAINID are to be requeued.
    Value must be specified as a single MAINID name.
    MAINID cannot be used with CPU, NODE, or AGENT.
    The MAINID parameter is ignored if used with a JOB parameter that references a specific job name or job number, but not if a job mask is specifie..
    The name must be one of the following values: ALL Indicates that all MAINIDs are considered. SYn Where n indicates a CPU assigned number as defined in the initialization file CPU statement.
    The value of n can range from 1 to 7. /SYn
    Where n indicates a CPU assigned number. The / indicates "not this MAINID."
    The value of n can range from 1 to 7.Limits:
    1 to 4 alphanumeric characters

- `--node` (string)

  - (Optional) Indicates the node name or mask that a node name must match for an XPJOB job,
    before it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    NODE cannot be used with CPU, MAINID, or AGENT.
    For any XPJOB that is requeued, a cancel request is sent to the node where the job is running
    (assuming the initialization file XPDEF statement parameter XPKILL=NO is not set).
    The status of the node or the computer that the node points to, determines whether the request is honored.
    Limits:
    1 to 8 alphanumeric characters

- `-q` (string)

  - (Optional) Used with JOB to indicate in which queue the job search is to occur. Possible values: ACT
    The active queue.RDY
    The ready queue

- `--type` (string)

  - (Optional) Flags the job after it returns to the request queue with a status of JCLERR instead of REQUE.
    If not coded, the status reflects REQUE.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Requeue the top line command on Instance1:

  - `zowe ca7 commands requeue --ca7Id Instance1`

### zowe › ca7 › commands › requeue › 1

The REQUEUE top line command moves jobs from the ready or active queues back to the request queue.
This command allows the use of the CA Workload Automation CA 7 Edition job restart facilities
after certain JCL, CPU, or node/agent failures, or job cancellation out of a CPU through the OS console.
This function is available as the Q option in the QM.1 CPU Jobs Status Prompt panel.

#### Usage

zowe ca7 commands requeue_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--agent` (string)

  - (Optional) Indicates the agent name or mask that an agent name must match for an agent job
    before it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    AGENT cannot be used with CPU, MAINID, or NODE.
    For any agent job that is requeued, a cancel request is sent to the agent running the job.
    The status of the agent or the computer on which the agent is running determines whether the request is honored.
    Limits:
    1 to 16 alphanumeric charactersDefault:
    * (all agent names)

- `--cpu` (string)

  - (Optional) Used with JOB to specify the CPU ID of active queue jobs that are to be requeued.
    The value identifies the CPU and corresponds to the CPU field displayed on the LQ command (the SMF identifier).
    CPU cannot be used with MAINID, NODE, or AGENT.
    The CPU parameter is ignored if used with a JOB parameter that references a specific job name or job number, but not if a job mask is specified.
    Limits:
    1 to 4 numeric characters

- `--force` (string)

  - (Optional) Resumes job completion for stranded jobs.
    When a job finishes executing, it must move to the request queue so that CA WA CA 7 Edition
    can process the database and queue updates that are required for job completion.
    But, if a job cannot be moved because of an I/O error or an out-of-space condition on the request queue,
    the job may be stranded in the ready or active queue, unable to complete
    Once the request queue error is corrected, you can use REQUEUE with FORCE=CMP to resume job completion for these jobs.
    Limits:
    CMP is the only value

- `--ca7#` (string)

  - (Optional) Indicates the job number
    must match before it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    If JOB is used alone, both the active and ready queues are searched for the specified job number.
    If JOB is used with Q, the search is restricted to the indicated queue. jobname,jobnumber and longjobname are mutually exclusive
    Default:
    * (all jobs)Limits:
    1 to 8 alphanumeric characters

- `--jobname` | `--jn` (string)

  - (Optional) Indicates the job name, or mask that a job name
    must match before it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    If JOB is used alone, both the active and ready queues are searched for the specified job.
    If JOB is used with Q, the search is restricted to the indicated queue. jobname,jobnumber and longjobname are mutually exclusive.
    Default:
    * (all jobs)Limits:
    1 to 8 alphanumeric characters

- `--longjobname` | `--lon` (string)

  - (Optional) Indicates the long job name or mask that a long job name must match before
    it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    If JOBL is used alone, both the active and ready queues are searched for the specified long job name.
    If JOBL is used with Q, the search is restricted to the indicated queue.jobname,jobnumber and longjobname are mutually exclusive
    Limits:
    1 to 64 alphanumeric characters

- `--mainid` (string)

  - (Optional) Used with JOB to indicate that only those jobs in the ready queue with this MAINID are to be requeued.
    Value must be specified as a single MAINID name.
    MAINID cannot be used with CPU, NODE, or AGENT.
    The MAINID parameter is ignored if used with a JOB parameter that references a specific job name or job number, but not if a job mask is specifie..
    The name must be one of the following values: ALL Indicates that all MAINIDs are considered. SYn Where n indicates a CPU assigned number as defined in the initialization file CPU statement.
    The value of n can range from 1 to 7. /SYn
    Where n indicates a CPU assigned number. The / indicates "not this MAINID."
    The value of n can range from 1 to 7.Limits:
    1 to 4 alphanumeric characters

- `--node` (string)

  - (Optional) Indicates the node name or mask that a node name must match for an XPJOB job,
    before it is moved back to the request queue, is given a restart requirement, and is flagged as having been requeued.
    NODE cannot be used with CPU, MAINID, or AGENT.
    For any XPJOB that is requeued, a cancel request is sent to the node where the job is running
    (assuming the initialization file XPDEF statement parameter XPKILL=NO is not set).
    The status of the node or the computer that the node points to, determines whether the request is honored.
    Limits:
    1 to 8 alphanumeric characters

- `-q` (string)

  - (Optional) Used with JOB to indicate in which queue the job search is to occur. Possible values: ACT
    The active queue.RDY
    The ready queue

- `--type` (string)

  - (Optional) Flags the job after it returns to the request queue with a status of JCLERR instead of REQUE.
    If not coded, the status reflects REQUE.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Requeue the top line command on default instance for ca7 number 0016:

  - `zowe ca7 commands requeue_1 --ca7# 0016`

### zowe › ca7 › commands › resolve

The RESOLV top line command creates or modifies processing schedules for jobs that are to be scheduled on a date/time basis.
Work that is scheduled by a trigger or on-request work that is DEMANDed or RUN has no direct relationship to a base calendar and
therefore does not require the use of this function

#### Usage

zowe ca7 commands resolve [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--job` (string)

  - (Optional) Limits selection for resolution to the jobs specified.
    If omitted, all job schedules are candidates for resolution.
    Value can be a specific job name or a generic name that identifies multiple jobs beginning with the specified characters.
    An asterisk (*) must be used to delimit the generic job name.
    The asterisk can appear in any of the eight positions but must immediately follow the last significant character of the job name requested.
    For example: AB* causes all jobs beginning with AB to be selected for resolution. * causes all job schedules to be selected for resolution.

- `--duplicate-date` | `--dd` (string)

  - (Optional) Indicates whether to produce specific duplicate day messages (SRC1-137) each time that two or more schedule IDs for the same job schedule a given day.
    The default is NO unless the extended resolve message option is set in the user profile by the /PROF command.

- `--old-year` | `--oy` (string)

  - (Optional) Specifies the year that is defined in the schedule member data
    (the value that is supplied by YEAR in the previous resolution that updated the schedule member).
    Only those candidate schedule members whose year data matches the OLDYR value are selected for resolution.
    If used, use one of the following values:
    empty
    Default:If omitted, only those schedule members that have not previously been resolved or whose schedules have expired are selected.
    yy Indicates a specific year.
    * Indicates all years and all schedules.

- `--print` (string)

  - (Optional) Specifies whether to display a month-by-month schedule day calendar after resolution of the defined member is complete.
    If used, value must be YES or NO (default).

- `--scal` (string)

  - (Optional) Value is the xx portion of the base calendar name, SCALyyxx.
    The SCAL value must also match the base calendar identifier (SCAL)
    specified in any SCHID of the schedule definition for the individual jobs.
    This value is used during the selection process of resolution to determine which schedule members to resolve.
    Required: No (unless JOB is omitted)
    * Indicates all SCALs.
    xx Indicates a specific SCAL.

- `--test` (string)

  - (Optional) Indicates whether schedule members are updated because of the resolution process.
    YES and NO are the only allowable values.
    YES
    Normal resolution occurs and all messages are printed, but no updating of the database occurs.
    This option can be used at a year-end or whenever a base calendar is changed to see the results of the resolution activity,
    without actually changing the schedule mask or affecting the current schedule process.
    YES is the default. NO
    Normal resolution occurs and all messages are printed, and updating of the database occurs.

- `--year` (string)

  - (Optional) Identifies the year of the base calendars against which the schedule is resolved.
    The value is the number that is the yy portion of the base calendar name, SCALyyxx./br>When a schedule is successfully updated, the YEAR value becomes part of the schedule data (see OLDYR).
    If the YEAR parameter is not specified, the current year is assumed to be the year from the system internal date and time.
    Also, if YEAR is not coded on the RESOLV, a determination is made to see whether the RESOLV is made
    within the period January 1 through June 30 as determined from system date and time.
    If so, the schedule is resolved against January through December of the current year.
    If a RESOLV is done within the period July 1 through December 31, the schedule is resolved against
    July 1 through December 31 of the current year and January 1 through June 30 of the next year.
    This behavior requires the existence of base calendars for calendar years involved.
    If a required base calendar is not available, an error message is issued.
    The schedule member is unresolved, unless a perpetual calendar is defined for this SCALyyXX.
    In that case, the calendar is generated from the PCALYYXX member in the perpetual calendar data set.
    nYEAR is optional.
    If YEAR is specified, the resolution is made against January through December of the year specified.
    Default: Current year
    Limits: 2 numeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates or modifies processing schedules for jobs AJOB* on instance1:

  - `zowe ca7 commands resolve --job AJOB* --ca7Id Instance1`

### zowe › ca7 › commands › resolve › 1

The RESOLV top line command creates or modifies processing schedules for jobs that are to be scheduled on a date/time basis.
Work that is scheduled by a trigger or on-request work that is DEMANDed or RUN has no direct relationship to a base calendar and
therefore does not require the use of this function

#### Usage

zowe ca7 commands resolve_1 [options]

#### Options

- `--job` (string)

  - (Optional) Limits selection for resolution to the jobs specified.
    If omitted, all job schedules are candidates for resolution.
    Value can be a specific job name or a generic name that identifies multiple jobs beginning with the specified characters.
    An asterisk (*) must be used to delimit the generic job name.
    The asterisk can appear in any of the eight positions but must immediately follow the last significant character of the job name requested.
    For example: AB* causes all jobs beginning with AB to be selected for resolution. * causes all job schedules to be selected for resolution.

- `--duplicate-date` | `--dd` (string)

  - (Optional) Indicates whether to produce specific duplicate day messages (SRC1-137) each time that two or more schedule IDs for the same job schedule a given day.
    The default is NO unless the extended resolve message option is set in the user profile by the /PROF command.

- `--old-year` | `--oy` (string)

  - (Optional) Specifies the year that is defined in the schedule member data
    (the value that is supplied by YEAR in the previous resolution that updated the schedule member).
    Only those candidate schedule members whose year data matches the OLDYR value are selected for resolution.
    If used, use one of the following values:
    empty
    Default:If omitted, only those schedule members that have not previously been resolved or whose schedules have expired are selected.
    yy Indicates a specific year.
    * Indicates all years and all schedules.

- `--print` (string)

  - (Optional) Specifies whether to display a month-by-month schedule day calendar after resolution of the defined member is complete.
    If used, value must be YES or NO (default).

- `--scal` (string)

  - (Optional) Value is the xx portion of the base calendar name, SCALyyxx.
    The SCAL value must also match the base calendar identifier (SCAL)
    specified in any SCHID of the schedule definition for the individual jobs.
    This value is used during the selection process of resolution to determine which schedule members to resolve.
    Required: No (unless JOB is omitted)
    * Indicates all SCALs.
    xx Indicates a specific SCAL.

- `--test` (string)

  - (Optional) Indicates whether schedule members are updated because of the resolution process.
    YES and NO are the only allowable values.
    YES
    Normal resolution occurs and all messages are printed, but no updating of the database occurs.
    This option can be used at a year-end or whenever a base calendar is changed to see the results of the resolution activity,
    without actually changing the schedule mask or affecting the current schedule process.
    YES is the default. NO
    Normal resolution occurs and all messages are printed, and updating of the database occurs.

- `--year` (string)

  - (Optional) Identifies the year of the base calendars against which the schedule is resolved.
    The value is the number that is the yy portion of the base calendar name, SCALyyxx./br>When a schedule is successfully updated, the YEAR value becomes part of the schedule data (see OLDYR).
    If the YEAR parameter is not specified, the current year is assumed to be the year from the system internal date and time.
    Also, if YEAR is not coded on the RESOLV, a determination is made to see whether the RESOLV is made
    within the period January 1 through June 30 as determined from system date and time.
    If so, the schedule is resolved against January through December of the current year.
    If a RESOLV is done within the period July 1 through December 31, the schedule is resolved against
    July 1 through December 31 of the current year and January 1 through June 30 of the next year.
    This behavior requires the existence of base calendars for calendar years involved.
    If a required base calendar is not available, an error message is issued.
    The schedule member is unresolved, unless a perpetual calendar is defined for this SCALyyXX.
    In that case, the calendar is generated from the PCALYYXX member in the perpetual calendar data set.
    nYEAR is optional.
    If YEAR is specified, the resolution is made against January through December of the year specified.
    Default: Current year
    Limits: 2 numeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates or modifies processing schedules for jobs AJOB* on default instance:

  - `zowe ca7 commands resolve_1 --job AJOB*`

### zowe › ca7 › commands › restart

The RESTART top line command restarts a job awaiting restart in the request queue.
This function is available as the F option on the QM.1 CPU Jobs Status Prompt panel.
You can also use QM.4 CPU Job in the Restart Status Prompt panel to accomplish a job restart.
If CA Workload Automation Restart Option for z/OS Schedulers is used, the CMT is updated with the appropriate restart data.
If CA Workload Automation Restart Option for z/OS Schedulers is not installed,
the starting and ending steps, USAGE, PROCESS, CONDCD, or SUP11STP have no significance.

The cross-platform jobs never use CA Workload Automation Restart Option for z/OS Schedulers services for restart functions.

#### Usage

zowe ca7 commands restart [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Indicates the individual job to restart, and the value must be a CA 7 job number.

- `--bypgdg` (string)

  - (Optional) Indicates whether CA Workload Automation Restart_XXX Option for z/OS Schedulers bypasses GDG logic on a restart/rerun.
    Value can be NO, YES, VER, or CAT.
    Default: CA Workload Automation Restart_XXX Option for z/OS Schedulers default value

- `--condcd` (string)

  - (Optional) Indicates an optional CA Workload Automation Restart_XXX Option for z/OS Schedulers condition code
    that the CA Workload Automation Restart_XXX Option for z/OS Schedulers step sets when the rerun is executed.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use
    and CA Workload Automation CA 7� Edition is inserting the RMS step.
    See the INSERT-RMS field on the DB.1 panel.
    Limits:
    1 to 4 numeric characters from 0 to 4095

- `--forcecomp` (string)

  - (Optional) Indicates whether to flag the job as a normal completion.
    If FORCECOMP=YES, the previous abnormal status of the job is ignored.
    Normal job completion processing is performed instead of a restart.
    Value can be NO or YES. NO is the default.

- `--lcc` (string)

  - (Optional) Indicates an optional condition code value that replaces the last condition code value for the step that the LSTP references and,
    optionally, LPSTP keywords.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Default: 0
    Limits:
    1 to 4 numeric characters from 0 to 4095

- `--lstp` (string)

  - (Optional) Indicates an optional step name that has its last condition code value reset in the
    CA Workload Automation Restart_XXX Option for z/OS Schedulers CMT.
    Code LSTP and LCC when LPSTP is specified.
    LSTP requires that an STPSTRT value is specified and that the LSTP step name occurs in the JCL of the job before the STPSTRT step name.
    This option is honored only when CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

- `--lpstp` (string)

  - (Optional) Indicates an optional step name referencing a procedure that has its last condition code value reset
    in the CA Workload Automation Restart_XXX Option for z/OS Schedulers CMT.
    If LPSTP is used, also code LSTP and LCC.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

- `--procstrt` (string)

  - (Optional) Indicates an optional step name referencing a procedure where processing is to start.
    If PROCESS=R and PROCSTRT are used, also code STPSTRT.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

- `--procend` (string)

  - (Optional) Indicates an optional step name referencing a procedure where processing is to end.
    If PROCESS=R and PROCEND are used, code STPEND.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

- `--process` (string)

  - (Optional) Indicates an optional CA Workload Automation Restart_XXX Option for z/OS Schedulers processing function code character to use in the restart/rerun.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use
    and CA WA CA 7 Edition is inserting the RMS step.
    See the INSERT-RMS field on the DB.1 panel. Value can be F, P, S, N, O, or R.
    Default: P
    Limits:
    1 alphabetic character

- `--reason` (string)

  - (Optional) Specifies a reason for the restart.
    If the CA Workload Automation Restart_XXX Option for z/OS Schedulers Reason-for-Rerun module is available,
    a code of up to four characters can be input and it is expanded.
    Any reason input or expanded is copied to the run log.
    This field is optional unless CA Workload Automation Restart_XXX Option for z/OS Schedulers requires a reason or
    REASON=YES was specified in the RESTART statement in the initialization file.
    Limits:
    1 to 40 alphanumeric characters

- `--stpend` (string)

  - (Optional) Indicates an optional step name or number at which processing is to end.
    f not specified, the last step of the job is assumed to be the ending step.
    Code STPEND when PROCEND is specified.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

- `--stpstrt` (string)

  - (Optional) Indicates an optional step name or number at which processing is to start.
    If STPSTRT is not coded, the first step of the job is assigned to be the starting step.
    Code STPSTRT when PROCSTRT is specified. This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    It can be one of stepname
    Specifies the step name or number at which processing is to start. *CMT*
    Indicates that the job is to restart with the step values currently on the CMT record. *RERUN*
    Indicates to rerun t the total job. If there are no restartable steps, specify *RERUN*. *RESUBP*
    Indicates that the CMT record of the job is set to production, and then the job is submitted.

- `--sup11stp` (string)

  - (Optional) Indicates whether to suppress the insertion of the CA Workload Automation Restart_XXX Option for z/OS Schedulers RMS step.
    If the job is resubmitted with SUP11STP=YES, the CA Workload Automation Restart_XXX Option for z/OS Schedulers step is not inserted.
    Only valid if CA WA CA 7 Edition is inserting the CA Workload Automation Restart_XXX Option for z/OS Schedulers step.
    See the INSERT-RMS field on the DB.1 panel.
    Value can be NO or YES. NO is the default.

- `--usage` (string)

  - (Optional) Indicates an optional CA Workload Automation Restart_XXX Option for z/OS Schedulers usage code of the character to use in the restart/rerun.
    For the values, see the CA Workload Automation Restart_XXX Option for z/OS Schedulers documentation.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use and
    CA WA CA 7 Edition is inserting the RMS step.
    See the INSERT-RMS field on the DB.1 panel.
    Limits:
    1 alphanumeric character

- `--ca11rstp` (string)

  - (Optional) Indicates that the RESTART command should return the job jobstep.procstep information from the CA Workload Automation Restart_XXX Option for z/OS Schedulers (CA-11) database (if available) in a SRJ2-55 message.
    YES or Y are the only valid values. If YES or Y is specified, no other keywords are allowed, and no attempt is made to restart the job.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Restarts a job awaiting restart in the request queue for jobs AJOB* on instance1:

  - `zowe ca7 commands restart --ca7# AJOB* --ca7Id Instance1`

### zowe › ca7 › commands › restart › 1

The RESTART top line command restarts a job awaiting restart in the request queue.
This function is available as the F option on the QM.1 CPU Jobs Status Prompt panel.
You can also use QM.4 CPU Job in the Restart Status Prompt panel to accomplish a job restart.
If CA Workload Automation Restart Option for z/OS Schedulers is used, the CMT is updated with the appropriate restart data.
If CA Workload Automation Restart Option for z/OS Schedulers is not installed,
the starting and ending steps, USAGE, PROCESS, CONDCD, or SUP11STP have no significance.

The cross-platform jobs never use CA Workload Automation Restart Option for z/OS Schedulers services for restart functions.

#### Usage

zowe ca7 commands restart_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Indicates the individual job to restart, and the value must be a CA 7 job number.

- `--bypgdg` (string)

  - (Optional) Indicates whether CA Workload Automation Restart_XXX Option for z/OS Schedulers bypasses GDG logic on a restart/rerun.
    Value can be NO, YES, VER, or CAT.
    Default: CA Workload Automation Restart_XXX Option for z/OS Schedulers default value

- `--condcd` (string)

  - (Optional) Indicates an optional CA Workload Automation Restart_XXX Option for z/OS Schedulers condition code
    that the CA Workload Automation Restart_XXX Option for z/OS Schedulers step sets when the rerun is executed.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use
    and CA Workload Automation CA 7� Edition is inserting the RMS step.
    See the INSERT-RMS field on the DB.1 panel.
    Limits:
    1 to 4 numeric characters from 0 to 4095

- `--forcecomp` (string)

  - (Optional) Indicates whether to flag the job as a normal completion.
    If FORCECOMP=YES, the previous abnormal status of the job is ignored.
    Normal job completion processing is performed instead of a restart.
    Value can be NO or YES. NO is the default.

- `--lcc` (string)

  - (Optional) Indicates an optional condition code value that replaces the last condition code value for the step that the LSTP references and,
    optionally, LPSTP keywords.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Default: 0
    Limits:
    1 to 4 numeric characters from 0 to 4095

- `--lstp` (string)

  - (Optional) Indicates an optional step name that has its last condition code value reset in the
    CA Workload Automation Restart_XXX Option for z/OS Schedulers CMT.
    Code LSTP and LCC when LPSTP is specified.
    LSTP requires that an STPSTRT value is specified and that the LSTP step name occurs in the JCL of the job before the STPSTRT step name.
    This option is honored only when CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

- `--lpstp` (string)

  - (Optional) Indicates an optional step name referencing a procedure that has its last condition code value reset
    in the CA Workload Automation Restart_XXX Option for z/OS Schedulers CMT.
    If LPSTP is used, also code LSTP and LCC.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

- `--procstrt` (string)

  - (Optional) Indicates an optional step name referencing a procedure where processing is to start.
    If PROCESS=R and PROCSTRT are used, also code STPSTRT.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

- `--procend` (string)

  - (Optional) Indicates an optional step name referencing a procedure where processing is to end.
    If PROCESS=R and PROCEND are used, code STPEND.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

- `--process` (string)

  - (Optional) Indicates an optional CA Workload Automation Restart_XXX Option for z/OS Schedulers processing function code character to use in the restart/rerun.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use
    and CA WA CA 7 Edition is inserting the RMS step.
    See the INSERT-RMS field on the DB.1 panel. Value can be F, P, S, N, O, or R.
    Default: P
    Limits:
    1 alphabetic character

- `--reason` (string)

  - (Optional) Specifies a reason for the restart.
    If the CA Workload Automation Restart_XXX Option for z/OS Schedulers Reason-for-Rerun module is available,
    a code of up to four characters can be input and it is expanded.
    Any reason input or expanded is copied to the run log.
    This field is optional unless CA Workload Automation Restart_XXX Option for z/OS Schedulers requires a reason or
    REASON=YES was specified in the RESTART statement in the initialization file.
    Limits:
    1 to 40 alphanumeric characters

- `--stpend` (string)

  - (Optional) Indicates an optional step name or number at which processing is to end.
    f not specified, the last step of the job is assumed to be the ending step.
    Code STPEND when PROCEND is specified.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    Limits:
    1 to 8 alphanumeric characters

- `--stpstrt` (string)

  - (Optional) Indicates an optional step name or number at which processing is to start.
    If STPSTRT is not coded, the first step of the job is assigned to be the starting step.
    Code STPSTRT when PROCSTRT is specified. This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use.
    It can be one of stepname
    Specifies the step name or number at which processing is to start. *CMT*
    Indicates that the job is to restart with the step values currently on the CMT record. *RERUN*
    Indicates to rerun t the total job. If there are no restartable steps, specify *RERUN*. *RESUBP*
    Indicates that the CMT record of the job is set to production, and then the job is submitted.

- `--sup11stp` (string)

  - (Optional) Indicates whether to suppress the insertion of the CA Workload Automation Restart_XXX Option for z/OS Schedulers RMS step.
    If the job is resubmitted with SUP11STP=YES, the CA Workload Automation Restart_XXX Option for z/OS Schedulers step is not inserted.
    Only valid if CA WA CA 7 Edition is inserting the CA Workload Automation Restart_XXX Option for z/OS Schedulers step.
    See the INSERT-RMS field on the DB.1 panel.
    Value can be NO or YES. NO is the default.

- `--usage` (string)

  - (Optional) Indicates an optional CA Workload Automation Restart_XXX Option for z/OS Schedulers usage code of the character to use in the restart/rerun.
    For the values, see the CA Workload Automation Restart_XXX Option for z/OS Schedulers documentation.
    This option is honored only if CA Workload Automation Restart_XXX Option for z/OS Schedulers is in use and
    CA WA CA 7 Edition is inserting the RMS step.
    See the INSERT-RMS field on the DB.1 panel.
    Limits:
    1 alphanumeric character

- `--ca11rstp` (string)

  - (Optional) Indicates that the RESTART command should return the job jobstep.procstep information from the CA Workload Automation Restart_XXX Option for z/OS Schedulers (CA-11) database (if available) in a SRJ2-55 message.
    YES or Y are the only valid values. If YES or Y is specified, no other keywords are allowed, and no attempt is made to restart the job.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Restarts a job awaiting restart in the request queue for jobs AJOB* on default instance:

  - `zowe ca7 commands restart_1 --ca7# AJOB*`

### zowe › ca7 › commands › run

The RUN top line command forces immediate scheduling of a job without verifying the availability
of any input requirements or performing the updates that typically follow successful job completion.
The RUN command is similar to the DEMAND command.
When DEMAND is used, input requirement checking is performed and database updating is done upon completion of the job.
When RUN is used, no requirement posting or job triggering occurs.

#### Usage

zowe ca7 commands run [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--job` (string)

  - Identifies the job to submit.
    The value must be a job name.
    If the job has not been defined in the database,
    this name must also match the member name for the JCL unless the job is defined in the database.
    See also JCLID. JOB and JOBL are mutually exclusive.
    Limits:
    1 to 8 alphanumeric characters

- `--jobl` (string)

  - Identifies the job to submit.
    The value must be a long job name.
    If the job has not been defined in the database, use JOB instead.
    See also JCLID. JOB and JOBL are mutually exclusive.
    Limits:
    1 to 64 alphanumeric characters

- `--arfset` (string)

  - (Optional) Identifies the ARF set name that is used for this run of the job.
    If **NONE** is specified, no ARF processing is performed for this run of the job.
    Limits:
    1 to 8 alphanumeric characters or **NONE**

- `--class` (string)

  - (Optional) Specifies the workload balancing class for resource checking.
    Limits:
    1 alphanumeric character

- `--dotm` (string)

  - (Optional) Specifies a due-out time-of-day for the job. If omitted, the current time (when command is processed) plus the lead time is used.
    Format: hhmm
    Defines the time-of-day where hh is the hours (0 through 24) and mm is minutes (00 through 59).
    You can omit leading zeros.

- `--exec` (string)

  - (Optional) Specifies whether to execute the job (YES/NO).
    If NO (N) is used, the job does not run but shows a normal completion as if it did run.
    The value that is specified here overrides the value that is coded on the job definition EXEC field.
    Default:
    The job definition panel EXEC value if job defined to CA WA CA 7 Edition; otherwise YES.

- `--jclid` (string)

  - (Optional) Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a numeric INDEX associated with the wanted JCL data set
    (on the JCL statement in the initialization file). If the job is defined in the database,
    the value must be the same as the value on the DB.1 panel or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLLIB field is required if the job is not defined in the database.
    JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed.
    Limits:
    1 to 3 numeric characters from 0 through 254 and from 256 through 999. 255 is reserved.
    Required:
    No, unless job is not defined in database

- `--jcllib` (string)

  - (Optional) Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a symbolic INDEX associated with the wanted JCL data set
    (on the JCL statement in the initialization file).
    If the job is defined in the database, the value must be the same as the value on the DB.1 panel
    or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLID field is required if the job is not defined in the database.
    JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed.Limits:
    2 to 16 alphanumeric characters beginning with ampersand (&)
    Required:
    No, unless job is not defined in database
    Note:
    A dynamic allocation failure on a JCL data set specified by JCLLIB causes the job to enter the request queue in SKELETON status.

- `--late` (string)

  - (Optional) Specifies whether notification occurs when the job becomes late.
    Specify YES (Y) to make the job eligible to be marked LATE.
    If NO (N) is used, the job is never marked LATE.
    The value that is specified here overrides the value that is coded on the job definition PROMPTS field.

- `--leadtm` (string)

  - (Optional) Specifies the lead (processing) time that is required for the job to run. If omitted, 1 hour is used.
    Format: hhmm
    Defines the time where hh is hours (0 through 23) and mm is minutes (00 through 59).
    You can omit leading zeros.

- `--mainid` (string)

  - (Optional) Specifies the MAINID, as defined in the initialization file CPU statement, to which the job is redirected. The value that is specified here overrides the value that is coded on the job definition MAINID field. The name must be one of the following values: ALL
    Specifies all CPUs are acceptable for executing the job. SYn
    n defines the CPU to which the job is being redirected. The value of n can range from 1 to 7. /SYn
    n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7. -SYn
    n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.Limits:
    Invalid with cross-platform jobs

- `--rms` (string)

  - (Optional) Specifies whether CA WA CA 7 Edition inserts the CA WA Restart_XXX Option RMS step.
    Specify YES (Y) to insert the step with the CA WA Restart_XXX Option processing code of P.
    Enter NO (N) to indicate that the RMS step is not inserted.
    The value that is specified here overrides the value that is coded on the job definition INSERT-RMS field.
    Default: The job definition panel INSERT-RMS value if job defined to CA WA CA 7 Edition; otherwise NO.
    Limits:
    Invalid for cross-platform jobs.
    Note: For more information, see [Interface with CA WA Restart_XXX Option for z/OS Schedulers](https://docops.ca.com/ca-workload-automation-ca-7-edition/12-0/en/configuring/interfaces/interfaces-with-other-products/interface-with-ca-wa-restart-option-for-z-os-schedulers/)

- `--schid` (string)

  - (Optional) Indicates the schedule ID to be used for evaluating JCL overrides that are scheduled with the #Jx or #Xx commands.
    If used, the value must be a schedule ID number.
    Default: 1
    Limits:
    1 to 3 numeric characters from 1 through 999
    Required:
    No (unless the SCHEDULE statement in the initialization file specifies SCHID=YES, then this parameter is required)

- `--time` (string)

  - (Optional) Establishes a submit time-of-day requirement for the job.
    Format: hhmm
    Defines the time-of-day where hh is hours (0 through 23) and mm is minutes (00 through 59).
    Leading zeros are not required.

- `--type` (string)

  - (Optional) Indicates that the job is being scheduled for rerun.
    The value must be specified as shown.
    TYPE=RES is optional.
    If used, a restart requirement is placed on the job, and the job has to be manually restarted.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Forces immediate scheduling of a job AJOB on instance1:

  - `zowe ca7 commands run --job AJOB --ca7Id Instance1`

### zowe › ca7 › commands › run › 1

The RUN top line command forces immediate scheduling of a job without verifying the availability
of any input requirements or performing the updates that typically follow successful job completion.
The RUN command is similar to the DEMAND command.
When DEMAND is used, input requirement checking is performed and database updating is done upon completion of the job.
When RUN is used, no requirement posting or job triggering occurs.

#### Usage

zowe ca7 commands run_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--job` (string)

  - Identifies the job to submit.
    The value must be a job name.
    If the job has not been defined in the database,
    this name must also match the member name for the JCL unless the job is defined in the database.
    See also JCLID. JOB and JOBL are mutually exclusive.
    Limits:
    1 to 8 alphanumeric characters

- `--jobl` (string)

  - Identifies the job to submit.
    The value must be a long job name.
    If the job has not been defined in the database, use JOB instead.
    See also JCLID. JOB and JOBL are mutually exclusive.
    Limits:
    1 to 64 alphanumeric characters

- `--arfset` (string)

  - (Optional) Identifies the ARF set name that is used for this run of the job.
    If **NONE** is specified, no ARF processing is performed for this run of the job.
    Limits:
    1 to 8 alphanumeric characters or **NONE**

- `--class` (string)

  - (Optional) Specifies the workload balancing class for resource checking.
    Limits:
    1 alphanumeric character

- `--dotm` (string)

  - (Optional) Specifies a due-out time-of-day for the job. If omitted, the current time (when command is processed) plus the lead time is used.
    Format: hhmm
    Defines the time-of-day where hh is the hours (0 through 24) and mm is minutes (00 through 59).
    You can omit leading zeros.

- `--exec` (string)

  - (Optional) Specifies whether to execute the job (YES/NO).
    If NO (N) is used, the job does not run but shows a normal completion as if it did run.
    The value that is specified here overrides the value that is coded on the job definition EXEC field.
    Default:
    The job definition panel EXEC value if job defined to CA WA CA 7 Edition; otherwise YES.

- `--jclid` (string)

  - (Optional) Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a numeric INDEX associated with the wanted JCL data set
    (on the JCL statement in the initialization file). If the job is defined in the database,
    the value must be the same as the value on the DB.1 panel or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLLIB field is required if the job is not defined in the database.
    JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed.
    Limits:
    1 to 3 numeric characters from 0 through 254 and from 256 through 999. 255 is reserved.
    Required:
    No, unless job is not defined in database

- `--jcllib` (string)

  - (Optional) Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a symbolic INDEX associated with the wanted JCL data set
    (on the JCL statement in the initialization file).
    If the job is defined in the database, the value must be the same as the value on the DB.1 panel
    or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLID field is required if the job is not defined in the database.
    JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed.Limits:
    2 to 16 alphanumeric characters beginning with ampersand (&)
    Required:
    No, unless job is not defined in database
    Note:
    A dynamic allocation failure on a JCL data set specified by JCLLIB causes the job to enter the request queue in SKELETON status.

- `--late` (string)

  - (Optional) Specifies whether notification occurs when the job becomes late.
    Specify YES (Y) to make the job eligible to be marked LATE.
    If NO (N) is used, the job is never marked LATE.
    The value that is specified here overrides the value that is coded on the job definition PROMPTS field.

- `--leadtm` (string)

  - (Optional) Specifies the lead (processing) time that is required for the job to run. If omitted, 1 hour is used.
    Format: hhmm
    Defines the time where hh is hours (0 through 23) and mm is minutes (00 through 59).
    You can omit leading zeros.

- `--mainid` (string)

  - (Optional) Specifies the MAINID, as defined in the initialization file CPU statement, to which the job is redirected. The value that is specified here overrides the value that is coded on the job definition MAINID field. The name must be one of the following values: ALL
    Specifies all CPUs are acceptable for executing the job. SYn
    n defines the CPU to which the job is being redirected. The value of n can range from 1 to 7. /SYn
    n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7. -SYn
    n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.Limits:
    Invalid with cross-platform jobs

- `--rms` (string)

  - (Optional) Specifies whether CA WA CA 7 Edition inserts the CA WA Restart_XXX Option RMS step.
    Specify YES (Y) to insert the step with the CA WA Restart_XXX Option processing code of P.
    Enter NO (N) to indicate that the RMS step is not inserted.
    The value that is specified here overrides the value that is coded on the job definition INSERT-RMS field.
    Default: The job definition panel INSERT-RMS value if job defined to CA WA CA 7 Edition; otherwise NO.
    Limits:
    Invalid for cross-platform jobs.
    Note: For more information, see [Interface with CA WA Restart_XXX Option for z/OS Schedulers](https://docops.ca.com/ca-workload-automation-ca-7-edition/12-0/en/configuring/interfaces/interfaces-with-other-products/interface-with-ca-wa-restart-option-for-z-os-schedulers/)

- `--schid` (string)

  - (Optional) Indicates the schedule ID to be used for evaluating JCL overrides that are scheduled with the #Jx or #Xx commands.
    If used, the value must be a schedule ID number.
    Default: 1
    Limits:
    1 to 3 numeric characters from 1 through 999
    Required:
    No (unless the SCHEDULE statement in the initialization file specifies SCHID=YES, then this parameter is required)

- `--time` (string)

  - (Optional) Establishes a submit time-of-day requirement for the job.
    Format: hhmm
    Defines the time-of-day where hh is hours (0 through 23) and mm is minutes (00 through 59).
    Leading zeros are not required.

- `--type` (string)

  - (Optional) Indicates that the job is being scheduled for rerun.
    The value must be specified as shown.
    TYPE=RES is optional.
    If used, a restart requirement is placed on the job, and the job has to be manually restarted.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Forces immediate scheduling of a job AJOB on default instance:

  - `zowe ca7 commands run_1 --job AJOB`

### zowe › ca7 › commands › runh

The RUNH command indicates to place the job in CA Workload Automation CA 7® Edition hold status.

#### Usage

zowe ca7 commands runh [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--job` (string)

  - Identifies the job to submit.
    The value must be a job name.
    If the job has not been defined in the database,
    this name must also match the member name for the JCL unless the job is defined in the database.
    See also JCLID. JOB and JOBL are mutually exclusive.
    Limits:
    1 to 8 alphanumeric characters

- `--jobl` (string)

  - Identifies the job to submit.
    The value must be a long job name.
    If the job has not been defined in the database, use JOB instead.
    See also JCLID. JOB and JOBL are mutually exclusive.
    Limits:
    1 to 64 alphanumeric characters

- `--arfset` (string)

  - (Optional) Identifies the ARF set name that is used for this run of the job.
    If **NONE** is specified, no ARF processing is performed for this run of the job.
    Limits:
    1 to 8 alphanumeric characters or **NONE**

- `--class` (string)

  - (Optional) Specifies the workload balancing class for resource checking.
    Limits:
    1 alphanumeric character

- `--dotm` (string)

  - (Optional) Specifies a due-out time-of-day for the job. If omitted, the current time (when command is processed) plus the lead time is used.
    Format: hhmm
    Defines the time-of-day where hh is the hours (0 through 24) and mm is minutes (00 through 59).
    You can omit leading zeros.

- `--exec` (string)

  - (Optional) Specifies whether to execute the job (YES/NO).
    If NO (N) is used, the job does not run but shows a normal completion as if it did run.
    The value that is specified here overrides the value that is coded on the job definition EXEC field.
    Default:
    The job definition panel EXEC value if job defined to CA WA CA 7 Edition; otherwise YES.

- `--jclid` (string)

  - (Optional) Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a numeric INDEX associated with the wanted JCL data set
    (on the JCL statement in the initialization file). If the job is defined in the database,
    the value must be the same as the value on the DB.1 panel or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLLIB field is required if the job is not defined in the database.
    JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed.
    Limits:
    1 to 3 numeric characters from 0 through 254 and from 256 through 999. 255 is reserved.
    Required:
    No, unless job is not defined in database

- `--jcllib` (string)

  - (Optional) Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a symbolic INDEX associated with the wanted JCL data set
    (on the JCL statement in the initialization file).
    If the job is defined in the database, the value must be the same as the value on the DB.1 panel
    or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLID field is required if the job is not defined in the database.
    JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed.
    Limits:
    2 to 16 alphanumeric characters beginning with ampersand (&)
    Required:
    No, unless job is not defined in database
    Note:
    A dynamic allocation failure on a JCL data set specified by JCLLIB causes the job to enter the request queue in SKELETON status.

- `--late` (string)

  - (Optional) Specifies whether notification occurs when the job becomes late.
    Specify YES (Y) to make the job eligible to be marked LATE.
    If NO (N) is used, the job is never marked LATE.
    The value that is specified here overrides the value that is coded on the job definition PROMPTS field.

- `--leadtm` (string)

  - (Optional) Specifies the lead (processing) time that is required for the job to run. If omitted, 1 hour is used.
    Format: hhmm
    Defines the time where hh is hours (0 through 23) and mm is minutes (00 through 59).
    You can omit leading zeros.

- `--mainid` (string)

  - (Optional) Specifies the MAINID, as defined in the initialization file CPU statement, to which the job is redirected. The value that is specified here overrides the value that is coded on the job definition MAINID field. The name must be one of the following values:
    ALL
    Specifies all CPUs are acceptable for executing the job.
    SYn
    n defines the CPU to which the job is being redirected. The value of n can range from 1 to 7.
    /SYn
    n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.
    -SYn
    n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.
    Limits:
    Invalid with cross-platform jobs

- `--rms` (string)

  - (Optional) Specifies whether CA WA CA 7 Edition inserts the CA WA Restart_XXX Option RMS step.
    Specify YES (Y) to insert the step with the CA WA Restart_XXX Option processing code of P.
    Enter NO (N) to indicate that the RMS step is not inserted.
    The value that is specified here overrides the value that is coded on the job definition INSERT-RMS field.
    Default: The job definition panel INSERT-RMS value if job defined to CA WA CA 7 Edition; otherwise NO.
    Limits:
    Invalid for cross-platform jobs.
    Note: For more information, see [Interface with CA WA Restart_XXX Option for z/OS Schedulers](https://docops.ca.com/ca-workload-automation-ca-7-edition/12-0/en/configuring/interfaces/interfaces-with-other-products/interface-with-ca-wa-restart-option-for-z-os-schedulers/)

- `--schid` (string)

  - (Optional) Indicates the schedule ID to be used for evaluating JCL overrides that are scheduled with the #Jx or #Xx commands.
    If used, the value must be a schedule ID number.
    Default: 1
    Limits:
    1 to 3 numeric characters from 1 through 999
    Required:
    No (unless the SCHEDULE statement in the initialization file specifies SCHID=YES, then this parameter is required)

- `--time` (string)

  - (Optional) Establishes a submit time-of-day requirement for the job.
    Format: hhmm
    Defines the time-of-day where hh is hours (0 through 23) and mm is minutes (00 through 59).
    Leading zeros are not required.

- `--type` (string)

  - (Optional) Indicates that the job is being scheduled for rerun.
    The value must be specified as shown.
    TYPE=RES is optional.
    If used, a restart requirement is placed on the job, and the job has to be manually restarted.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Places the job AJOB on instance1 on hold status:

  - `zowe ca7 commands runh --job# AJOB --ca7Id Instance1`

### zowe › ca7 › commands › runh › 1

The RUNH command indicates to place the job in CA Workload Automation CA 7® Edition hold status.

#### Usage

zowe ca7 commands runh_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--job` (string)

  - Identifies the job to submit.
    The value must be a job name.
    If the job has not been defined in the database,
    this name must also match the member name for the JCL unless the job is defined in the database.
    See also JCLID. JOB and JOBL are mutually exclusive.
    Limits:
    1 to 8 alphanumeric characters

- `--jobl` (string)

  - Identifies the job to submit.
    The value must be a long job name.
    If the job has not been defined in the database, use JOB instead.
    See also JCLID. JOB and JOBL are mutually exclusive.
    Limits:
    1 to 64 alphanumeric characters

- `--arfset` (string)

  - (Optional) Identifies the ARF set name that is used for this run of the job.
    If **NONE** is specified, no ARF processing is performed for this run of the job.
    Limits:
    1 to 8 alphanumeric characters or **NONE**

- `--class` (string)

  - (Optional) Specifies the workload balancing class for resource checking.
    Limits:
    1 alphanumeric character

- `--dotm` (string)

  - (Optional) Specifies a due-out time-of-day for the job. If omitted, the current time (when command is processed) plus the lead time is used.
    Format: hhmm
    Defines the time-of-day where hh is the hours (0 through 24) and mm is minutes (00 through 59).
    You can omit leading zeros.

- `--exec` (string)

  - (Optional) Specifies whether to execute the job (YES/NO).
    If NO (N) is used, the job does not run but shows a normal completion as if it did run.
    The value that is specified here overrides the value that is coded on the job definition EXEC field.
    Default:
    The job definition panel EXEC value if job defined to CA WA CA 7 Edition; otherwise YES.

- `--jclid` (string)

  - (Optional) Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a numeric INDEX associated with the wanted JCL data set
    (on the JCL statement in the initialization file). If the job is defined in the database,
    the value must be the same as the value on the DB.1 panel or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLLIB field is required if the job is not defined in the database.
    JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed.</p>Limits:
    1 to 3 numeric characters from 0 through 254 and from 256 through 999. 255 is reserved.
    Required:
    No, unless job is not defined in database

- `--jcllib` (string)

  - (Optional) Defines the JCL data set that contains the execution JCL to be submitted.
    If used, the value must be a symbolic INDEX associated with the wanted JCL data set
    (on the JCL statement in the initialization file).
    If the job is defined in the database, the value must be the same as the value on the DB.1 panel
    or the Optional PARMLIB/Parmlib value on the DB.10 and DB.11 panels.
    This field or the JCLID field is required if the job is not defined in the database.
    JCLID and JCLLIB are mutually exclusive.
    Note:
    Attempts to run cross-platform jobs that are not defined to the database fail because they are treated as regular CPU jobs when processed.
    Limits:
    2 to 16 alphanumeric characters beginning with ampersand (&)
    Required:
    No, unless job is not defined in database
    Note:
    A dynamic allocation failure on a JCL data set specified by JCLLIB causes the job to enter the request queue in SKELETON status.

- `--late` (string)

  - (Optional) Specifies whether notification occurs when the job becomes late.
    Specify YES (Y) to make the job eligible to be marked LATE.
    If NO (N) is used, the job is never marked LATE.
    The value that is specified here overrides the value that is coded on the job definition PROMPTS field.

- `--leadtm` (string)

  - (Optional) Specifies the lead (processing) time that is required for the job to run. If omitted, 1 hour is used.
    Format: hhmm
    Defines the time where hh is hours (0 through 23) and mm is minutes (00 through 59).
    You can omit leading zeros.

- `--mainid` (string)

  - (Optional) Specifies the MAINID, as defined in the initialization file CPU statement, to which the job is redirected. The value that is specified here overrides the value that is coded on the job definition MAINID field. The name must be one of the following values: ALL
    Specifies all CPUs are acceptable for executing the job. SYn
    n defines the CPU to which the job is being redirected. The value of n can range from 1 to 7. /SYn
    n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7. -SYn
    n defines a CPU to which the job cannot be submitted. The value of n can range from 1 to 7.
    Limits:
    Invalid with cross-platform jobs

- `--rms` (string)

  - (Optional) Specifies whether CA WA CA 7 Edition inserts the CA WA Restart_XXX Option RMS step.
    Specify YES (Y) to insert the step with the CA WA Restart_XXX Option processing code of P.
    Enter NO (N) to indicate that the RMS step is not inserted.
    The value that is specified here overrides the value that is coded on the job definition INSERT-RMS field.
    Default: The job definition panel INSERT-RMS value if job defined to CA WA CA 7 Edition; otherwise NO.
    Limits:
    Invalid for cross-platform jobs.
    Note: For more information, see [Interface with CA WA Restart_XXX Option for z/OS Schedulers](https://docops.ca.com/ca-workload-automation-ca-7-edition/12-0/en/configuring/interfaces/interfaces-with-other-products/interface-with-ca-wa-restart-option-for-z-os-schedulers/)

- `--schid` (string)

  - (Optional) Indicates the schedule ID to be used for evaluating JCL overrides that are scheduled with the #Jx or #Xx commands.
    If used, the value must be a schedule ID number.
    Default: 1
    Limits:
    1 to 3 numeric characters from 1 through 999
    Required:
    No (unless the SCHEDULE statement in the initialization file specifies SCHID=YES, then this parameter is required)

- `--time` (string)

  - (Optional) Establishes a submit time-of-day requirement for the job.
    Format: hhmm
    Defines the time-of-day where hh is hours (0 through 23) and mm is minutes (00 through 59).
    Leading zeros are not required.

- `--type` (string)

  - (Optional) Indicates that the job is being scheduled for rerun.
    The value must be specified as shown.
    TYPE=RES is optional.
    If used, a restart requirement is placed on the job, and the job has to be manually restarted.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Places the job AJOB on default instance on hold status:

  - `zowe ca7 commands runh_1 --job AJOB`

### zowe › ca7 › commands › submit

The SUBMIT top line command modifies and expedites the process of job submission for jobs already residing in the queues.
This processing can be accomplished in two ways:

All outstanding input requirements for the specified jobs can be posted as satisfied.
Optionally, by specifying EXPRESS=YES, a priority can be set for a specific job.
This priority ensures that the job is submitted ahead of other jobs also ready for submission.
Note:
EXPRESS=YES has no effect when workload balancing is being used.

#### Usage

zowe ca7 commands submit [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Specifies the CA 7 job number of the job whose requirements you want to post as satisfied.Limits:
    1 to 4 alphanumeric characters

- `--express` (string)

  - (Optional) Indicates to place the job ahead of all other jobs (those jobs without EXPRESS=YES) for submission.
    The value must be coded as shown. Not valid if workload balancing is being used.
    Use of EXPRESS=YES does not establish an increased execution priority for a job.
    Rather, it ensures that nonexpress jobs are not submitted ahead of a job that is flagged as an express job.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Submits the job with ca7 number 0123 on Instance1:

  - `zowe ca7 commands submit --ca7# 0123 --ca7Id Instance1`

### zowe › ca7 › commands › submit › 1

The SUBMIT top line command modifies and expedites the process of job submission for jobs already residing in the queues.
This processing can be accomplished in two ways:

All outstanding input requirements for the specified jobs can be posted as satisfied.
Optionally, by specifying EXPRESS=YES, a priority can be set for a specific job.
This priority ensures that the job is submitted ahead of other jobs also ready for submission.
Note:
EXPRESS=YES has no effect when workload balancing is being used.

#### Usage

zowe ca7 commands submit_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Specifies the CA 7 job number of the job whose requirements you want to post as satisfied.Limits:
    1 to 4 alphanumeric characters

- `--express` (string)

  - (Optional) Indicates to place the job ahead of all other jobs (those jobs without EXPRESS=YES) for submission.
    The value must be coded as shown. Not valid if workload balancing is being used.
    Use of EXPRESS=YES does not establish an increased execution priority for a job.
    Rather, it ensures that nonexpress jobs are not submitted ahead of a job that is flagged as an express job.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Submits the job with ca7 number 0123 on default instance:

  - `zowe ca7 commands submit_1 --ca7# 0123`

### zowe › ca7 › commands › subtm

The SUBTM command modifies the required submit time-of-day for a job in the request queue. These modifications are permitted:

Add a specific submit time requirement where none was previously defined.
Remove a defined submit time requirement.
Change an existing submit time requirement to either earlier or later than defined.

#### Usage

zowe ca7 commands subtm [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Specifies the CA 7 job number of the job or which you want to add, modify, or remove a submit time-of-day requirement.Limits:
    1 to 4 alphanumeric characters

- `--time` (string)

  - (Optional) Specifies the new submit time-of-day in hours and minutes.
    TIME is required to add a submit time-of-day requirement when none exists or to change an existing requirement.
    If TIME is omitted, an existing submit time-of-day restriction is removed. Format:hhmm
    Defines the time-of-day where hh is hours (0 through 24) and
    mm is minutes (00 through 59). Maximum is 2400.
    If the value given is less than the current time (when the command is processed), the submit day is incremented by one.

- `--date` (string)

  - (Optional) Specifies new submit date in Julian date format.
    If DATE is not specified, default is the current date.
    If DATE is specified, TIME is then required.
    Limits:
    If used, specify DOTM or TIME. yyddd Defines the Julian date to submit the job.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Modifies submit time for the job with ca7 number 0123 on default instance:

  - `zowe ca7 commands subtm --ca7# 0123 --ca7Id Instance1`

### zowe › ca7 › commands › subtm › 1

The SUBTM command modifies the required submit time-of-day for a job in the request queue. These modifications are permitted:

Add a specific submit time requirement where none was previously defined.
Remove a defined submit time requirement.
Change an existing submit time requirement to either earlier or later than defined.

#### Usage

zowe ca7 commands subtm_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Specifies the CA 7 job number of the job or which you want to add, modify, or remove a submit time-of-day requirement.Limits:
    1 to 4 alphanumeric characters

- `--time` (string)

  - (Optional) Specifies the new submit time-of-day in hours and minutes.
    TIME is required to add a submit time-of-day requirement when none exists or to change an existing requirement.
    If TIME is omitted, an existing submit time-of-day restriction is removed. Format:hhmm
    Defines the time-of-day where hh is hours (0 through 24) and
    mm is minutes (00 through 59). Maximum is 2400.
    If the value given is less than the current time (when the command is processed), the submit day is incremented by one.

- `--date` (string)

  - (Optional) Specifies new submit date in Julian date format.
    If DATE is not specified, default is the current date.
    If DATE is specified, TIME is then required.
    Limits:
    If used, specify DOTM or TIME. yyddd Defines the Julian date to submit the job.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Modifies submit time for the job with ca7 number 0123 on default instance:

  - `zowe ca7 commands subtm_1 --ca7# 0123`

### zowe › ca7 › commands › verify

The VERIFY command establishes or satisfies a manual verification requirement for a currently scheduled run of the job in the request queue before its execution.
A verification requirement is established for the currently scheduled run to ensure completion of some unusual activity before job submission.

#### Usage

zowe ca7 commands verify [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Specifies the CA 7 assigned job number of the job for which a verification requirement is established or satisfied.
    Limits:
    1 to 4 alphanumeric characters

- `--set` (string)

  - Sets the verification requirement.
    ON
    Establishes a manual verification requirement that did not previously exist.
    OFF
    Indicates that a previously established manual verification requirement is satisfied and can be
    removed. A verification requirement no longer appears on the requirements list in the request queue.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Submits a manual verification requirement for the job with ca7 number 0123 on Instance1:

  - `zowe ca7 commands verify --ca7# 0123 --ca7Id Instance1`

### zowe › ca7 › commands › verify › 1

The VERIFY command establishes or satisfies a manual verification requirement for a currently scheduled run of the job in the request queue before its execution.
A verification requirement is established for the currently scheduled run to ensure completion of some unusual activity before job submission.

#### Usage

zowe ca7 commands verify_1 [options]

#### Options

- `--key` (string)

  - The command transaction key

- `--ca7#` (string)

  - Specifies the CA 7 assigned job number of the job for which a verification requirement is established or satisfied.
    Limits:
    1 to 4 alphanumeric characters

- `--set` (string)

  - Sets the verification requirement.
    ON
    Establishes a manual verification requirement that did not previously exist.
    OFF
    Indicates that a previously established manual verification requirement is satisfied and can be
    removed. A verification requirement no longer appears on the requirements list in the request queue.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Submits a manual verification requirement for the job with ca7 number 0123 on Default Instance:

  - `zowe ca7 commands verify_1 --ca7# 0123`

## zowe › ca7 › dataset

All the available commands listed in the Dataset section.

### zowe › ca7 › dataset › delete-dataset

Delete the definition of a dataset

#### Usage

zowe ca7 dataset delete-dataset [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--dataset-name` | `--dname` (string)

  - (Required if dataset-number is omitted) Specifies the data set and must be the fully qualified data set name.
    Limits: 1 to 44 alphanumeric characters
    Note: dataset-name is not required to conform to MVS data set name standards. Embedded blanks and special characters such as slashes, dashes, and underscores are permitted. All alphabetic characters are uppercased.

- `--dataset-number` | `--dnum` (string)

  - (Required if dataset-name is omitted) Specifies the data set to use. The value must be the numeric value that CA 7 already assigned.
    Limits: 1 to 8 numeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Delete the definition of a dataset named DATA.SET.NAME on Instance1:

  - `zowe ca7 dataset delete-dataset --ca7Id Instance1 --dname DATA.SET.NAME`

### zowe › ca7 › dataset › delete-dataset › 1

Delete the definition of a dataset

#### Usage

zowe ca7 dataset delete-dataset_1 [options]

#### Options

- `--dataset-name` | `--dname` (string)

  - (Required if dataset-number is omitted) Specifies the data set and must be the fully qualified data set name.
    Limits: 1 to 44 alphanumeric characters
    Note: dataset-name is not required to conform to MVS data set name standards. Embedded blanks and special characters such as slashes, dashes, and underscores are permitted. All alphabetic characters are uppercased.

- `--dataset-number` | `--dnum` (string)

  - (Required if dataset-name is omitted) Specifies the data set to use. The value must be the numeric value that CA 7 already assigned.
    Limits: 1 to 8 numeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Delete the definition of a dataset named DATA.SET.NAME:

  - `zowe ca7 dataset delete-dataset_1 --dname DATA.SET.NAME`

### zowe › ca7 › dataset › delete-trigger

Delete Dataset Trigger definition

#### Usage

zowe ca7 dataset delete-trigger [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--triggered-job` | `--tj` (string)

  - Specifies the job name that the completion of the triggering dataset triggers.
    Limits: 1 to 8 alphanumeric characters

#### Options

- `--dataset-name` | `--dname` (string)

  - (Required if dataset-number is omitted) Specifies the data set name whose creation/update causes triggering of a job.
    Note: For VSAM files, specify the cluster name.
    Limits: 1 to 44 alphanumeric characters

- `--dataset-number` | `--dnum` (string)

  - (Required if dataset-name is omitted) Specifies the existing data set number whose creation causes triggering. The number is the value that CA 7 assigned to the data set.
    Limits: 1 to 8 numeric characters

- `--schid` (string)

  - (Optional) Specifies for which schedule ID of the triggering dataset the triggered-job is scheduled.
    Note: If the data set is one that is tracked with use of SASSXDSN (externally tracked data sets), the schid field must be 000 for the trigger to work
    Default: 0 (all schedule IDs)
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes dataset trigger definition for triggered job JOBA on Instance1:

  - `zowe ca7 dataset delete-trigger --ca7Id Instance1 --tj JOBA`

### zowe › ca7 › dataset › delete-trigger › 1

Delete Dataset Trigger definition

#### Usage

zowe ca7 dataset delete-trigger_1 [options]

#### Options

- `--dataset-name` | `--dname` (string)

  - (Required if dataset-number is omitted) Specifies the data set name whose creation/update causes triggering of a job.
    Note: For VSAM files, specify the cluster name.
    Limits: 1 to 44 alphanumeric characters

- `--dataset-number` | `--dnum` (string)

  - (Required if dataset-name is omitted) Specifies the existing data set number whose creation causes triggering. The number is the value that CA 7 assigned to the data set.
    Limits: 1 to 8 numeric characters

- `--schid` (string)

  - (Optional) Specifies for which schedule ID of the triggering dataset the triggered-job is scheduled.
    Note: If the data set is one that is tracked with use of SASSXDSN (externally tracked data sets), the schid field must be 000 for the trigger to work
    Default: 0 (all schedule IDs)
    Limits: 1 to 3 numeric characters from 0 through 999

#### Required Options

- `--triggered-job` | `--tj` (string)

  - Specifies the job name that the completion of the triggering dataset triggers.
    Limits: 1 to 8 alphanumeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes dataset trigger definition for triggered job JOBA:

  - `zowe ca7 dataset delete-trigger_1 --tj JOBA`

### zowe › ca7 › dataset › post-dataset

Create a new definition of a dataset

#### Usage

zowe ca7 dataset post-dataset [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--dataset-name` | `--dname` (string)

  - Specifies the data set and must be the fully qualified data set name.
    Limits: 1 to 44 alphanumeric characters
    Note: dataset-name is not required to conform to MVS data set name standards. Embedded blanks and special characters such as slashes, dashes, and underscores are permitted. All alphabetic characters are uppercased.

#### Options

- `--type` (string)

  - (Optional) Specifies the data set type.
    Valid values are:
    NORM = Internal means both the creating-job and using-jobs for this data set are known to CA 7.
    External means the creating-job, using-jobs, or both for this data set are not known to CA 7.PERM = Specifies this data set is always available for inputDefault: NORM
    Note: When a data set is marked PERM, no SMF records are captured. PERM means no data set triggering can occur with this type of data set

- `--gdg` (string)

  - (Optional) Specifies whether this data set is a generation data group.
    Valid values are:
    Y = The data set is a generation data groupN = The data set is not a generation data groupDefault: N
    Note: The specific GDG creations cannot be used for posting requirements or for triggering jobs. Posting and triggering are done based on the creation/updating (SMF 15 record) of any generation of the GDG.

- `--smf-feedback-required` | `--sfr` (string)

  - (Optional) Specifies whether the interface to System Management Facility (SMF) inserts the values for DSORG, RECFM, LRECL, and BLKSIZE when this data set is next used. Unless the value is reset, this insertion is only done once.
    Valid values are:
    Y = SMF inserts the values when the data set is next usedN = SMF does not insert the values when the data set is next usedDefault: Y
    Note: After the first time the job that creates this data set runs under CA 7, this field is reset to N. If the data set attributes change, this field must be reset to Y. The changed attribute field (that is, DSORG, RECFM) must be zeroed (if numeric) or blanked out. This process causes CA 7 to record the new values when the job is run again.

- `--post-at-close-time` | `--pact` (string)

  - (Optional) Specifies when to post the creation or update of a data set to the database and queues. This process does not ensure successful step or job termination.
    Valid values are:
    Y = The action takes place when the SMF data set creation record is received (when the data set is closed)N = Causes triggering or posting action to take place at the job terminationDefault: N

- `--device` (string)

  - (Optional) Specifies a device type.
    Valid values are:
    TAPEDASD

- `--dsorg` (string)

  - (Optional) Specifies the data set organization. This value is the same as the DSORG specified in the DCB subparameter in the JCL.
    Limits: 1 to 3 alphanumeric characters

- `--recfm` (string)

  - (Optional) Specifies the record format of the data set. This value is the same as the RECFM specified in the DCB subparameter in the JCL.
    Limits: 1 to 5 alphanumeric characters

- `--lrecl` (string)

  - (Optional) Specifies the logical record length of the data set. This value is the same as the LRECL specified in the DCB subparameter in the JCL.
    Limits: 1 to 5 numeric characters

- `--blksize` (string)

  - (Optional) Specifies the block size of the data set. This value is the same as the BLKSIZE specified in the DCB subparameter in the JCL.
    Limits: 1 to 5 numeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Create a new dataset named DATASET.NAME.TEST of type NORM and data set is not a generation data group on Instance1:

  - `zowe ca7 dataset post-dataset --dname DATASET.NAME.TEST --type NORM --gdg N --ca7Id Instance1`

### zowe › ca7 › dataset › post-dataset › 1

Create a new definition of a dataset

#### Usage

zowe ca7 dataset post-dataset_1 [options]

#### Required Options

- `--dataset-name` | `--dname` (string)

  - Specifies the data set and must be the fully qualified data set name.
    Limits: 1 to 44 alphanumeric characters
    Note: dataset-name is not required to conform to MVS data set name standards. Embedded blanks and special characters such as slashes, dashes, and underscores are permitted. All alphabetic characters are uppercased.

#### Options

- `--type` (string)

  - (Optional) Specifies the data set type.
    Valid values are:
    NORM = Internal means both the creating-job and using-jobs for this data set are known to CA 7.
    External means the creating-job, using-jobs, or both for this data set are not known to CA 7.PERM = Specifies this data set is always available for inputDefault: NORM
    Note: When a data set is marked PERM, no SMF records are captured. PERM means no data set triggering can occur with this type of data set

- `--gdg` (string)

  - (Optional) Specifies whether this data set is a generation data group.
    Valid values are:
    Y = The data set is a generation data groupN = The data set is not a generation data groupDefault: N
    Note: The specific GDG creations cannot be used for posting requirements or for triggering jobs. Posting and triggering are done based on the creation/updating (SMF 15 record) of any generation of the GDG.

- `--smf-feedback-required` | `--sfr` (string)

  - (Optional) Specifies whether the interface to System Management Facility (SMF) inserts the values for DSORG, RECFM, LRECL, and BLKSIZE when this data set is next used. Unless the value is reset, this insertion is only done once.
    Valid values are:
    Y = SMF inserts the values when the data set is next usedN = SMF does not insert the values when the data set is next usedDefault: Y
    Note: After the first time the job that creates this data set runs under CA 7, this field is reset to N. If the data set attributes change, this field must be reset to Y. The changed attribute field (that is, DSORG, RECFM) must be zeroed (if numeric) or blanked out. This process causes CA 7 to record the new values when the job is run again.

- `--post-at-close-time` | `--pact` (string)

  - (Optional) Specifies when to post the creation or update of a data set to the database and queues. This process does not ensure successful step or job termination.
    Valid values are:
    Y = The action takes place when the SMF data set creation record is received (when the data set is closed)N = Causes triggering or posting action to take place at the job terminationDefault: N

- `--device` (string)

  - (Optional) Specifies a device type.
    Valid values are:
    TAPEDASD

- `--dsorg` (string)

  - (Optional) Specifies the data set organization. This value is the same as the DSORG specified in the DCB subparameter in the JCL.
    Limits: 1 to 3 alphanumeric characters

- `--recfm` (string)

  - (Optional) Specifies the record format of the data set. This value is the same as the RECFM specified in the DCB subparameter in the JCL.
    Limits: 1 to 5 alphanumeric characters

- `--lrecl` (string)

  - (Optional) Specifies the logical record length of the data set. This value is the same as the LRECL specified in the DCB subparameter in the JCL.
    Limits: 1 to 5 numeric characters

- `--blksize` (string)

  - (Optional) Specifies the block size of the data set. This value is the same as the BLKSIZE specified in the DCB subparameter in the JCL.
    Limits: 1 to 5 numeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Create a new dataset named DATASET.NAME.TEST of type NORM and data set is not a generation data group:

  - `zowe ca7 dataset post-dataset_1 --dname DATASET.NAME.TEST --type NORM --gdg N`

### zowe › ca7 › dataset › post-trigger

Create Dataset Trigger definition

#### Usage

zowe ca7 dataset post-trigger [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--triggered-job` | `--tj` (string)

  - Specifies the job name that the completion of the triggering dataset triggers.
    Limits: 1 to 8 alphanumeric characters

#### Options

- `--dataset-name` | `--dname` (string)

  - (Required if dataset-number is omitted) Specifies the data set name whose creation/update causes triggering of a job.
    Note: For VSAM files, specify the cluster name.
    Limits: 1 to 44 alphanumeric characters

- `--dataset-number` | `--dnum` (string)

  - (Required if dataset-name is omitted) Specifies the existing data set number whose creation causes triggering. The number is the value that CA 7 assigned to the data set.
    Limits: 1 to 8 numeric characters

- `--schid` (string)

  - (Optional) Specifies for which schedule ID of the triggering dataset the triggered-job is scheduled.
    Note: If the data set is one that is tracked with use of SASSXDSN (externally tracked data sets), the schid field must be 000 for the trigger to work
    Default: 0 (all schedule IDs)
    Limits: 1 to 3 numeric characters from 0 through 999

- `--triggered-job-schid` | `--tjs` (string)

  - (Optional) Denotes a replacement schedule ID to use when the triggered-job is placed into the request queue.
    Default: 0 (no replacement)
    Limits: 1 to 3 numeric characters from 0 through 999
    Note: If triggered-job-schid is used, it replaces the schid value of the triggered job. Any jobs triggered (by triggered-job or data sets it creates) use this triggered-job-schid for their schedule ID unless they also have a triggered-job-schid value.

- `--triggered-job-due-out-time` | `--tjdot` (string)

  - (Required if triggered-job-queue-time is omitted) Specifies the due-out time of day of the triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-queue-time must be omitted.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400. If specified, the lowest value is 10.
    Note: If used and the due-out-time of the triggering job is after the triggered-job-due-out-time, the following calendar day is assumed.

- `--triggered-job-queue-time` | `--tjqt` (string)

  - (Required if triggered-job-due-out-time is omitted) Specifies the elapsed queue time of triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-due-out-time must be omitted because due-out time is then calculated as deadline time plus runtime.
    Deadline time is calculated as current date/time plus queue time.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-lead-time` | `--tjlt` (string)

  - (Optional) Specifies the elapsed lead time for triggered-job rounded to 10-minute increments. This parameter specifies the lead or processing time necessary to ensure triggered-job meets its due-out time.
    Default: 0000
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-submit-time` | `--tjst` (string)

  - (Optional) Imposes a submit time of day requirement on triggered-job. When used, the job is not submitted before this time.
    The triggered-job-submit-time is always rounded down to 15-minute increments.
    Default: 0 (no specific submit time requirement)
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400.
    Note: If triggered-job-queue-time is used, the date for the submit time requirement is the same as the deadline start date.

    If triggered-job-due-out-time is used and the triggered-job-submit-time is less than the triggered-job-due-out-time, the date for the triggered-job-submit-time is the same as the deadline start date. Otherwise, the triggered-job-submit-time date is the previous day.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates dataset trigger definition for triggered job JOBA on Instance1:

  - `zowe ca7 dataset post-trigger --ca7Id Instance1 --tj JOBA`

### zowe › ca7 › dataset › post-trigger › 1

Create Dataset Trigger definition for DEFAULT_INSTANCE

#### Usage

zowe ca7 dataset post-trigger_1 [options]

#### Options

- `--dataset-name` | `--dname` (string)

  - (Required if dataset-number is omitted) Specifies the data set name whose creation/update causes triggering of a job.
    Note: For VSAM files, specify the cluster name.
    Limits: 1 to 44 alphanumeric characters

- `--dataset-number` | `--dnum` (string)

  - (Required if dataset-name is omitted) Specifies the existing data set number whose creation causes triggering. The number is the value that CA 7 assigned to the data set.
    Limits: 1 to 8 numeric characters

- `--schid` (string)

  - (Optional) Specifies for which schedule ID of the triggering dataset the triggered-job is scheduled.
    Note: If the data set is one that is tracked with use of SASSXDSN (externally tracked data sets), the schid field must be 000 for the trigger to work
    Default: 0 (all schedule IDs)
    Limits: 1 to 3 numeric characters from 0 through 999

- `--triggered-job-schid` | `--tjs` (string)

  - (Optional) Denotes a replacement schedule ID to use when the triggered-job is placed into the request queue.
    Default: 0 (no replacement)
    Limits: 1 to 3 numeric characters from 0 through 999
    Note: If triggered-job-schid is used, it replaces the schid value of the triggered job. Any jobs triggered (by triggered-job or data sets it creates) use this triggered-job-schid for their schedule ID unless they also have a triggered-job-schid value.

- `--triggered-job-due-out-time` | `--tjdot` (string)

  - (Required if triggered-job-queue-time is omitted) Specifies the due-out time of day of the triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-queue-time must be omitted.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400. If specified, the lowest value is 10.
    Note: If used and the due-out-time of the triggering job is after the triggered-job-due-out-time, the following calendar day is assumed.

- `--triggered-job-queue-time` | `--tjqt` (string)

  - (Required if triggered-job-due-out-time is omitted) Specifies the elapsed queue time of triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-due-out-time must be omitted because due-out time is then calculated as deadline time plus runtime.
    Deadline time is calculated as current date/time plus queue time.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-lead-time` | `--tjlt` (string)

  - (Optional) Specifies the elapsed lead time for triggered-job rounded to 10-minute increments. This parameter specifies the lead or processing time necessary to ensure triggered-job meets its due-out time.
    Default: 0000
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-submit-time` | `--tjst` (string)

  - (Optional) Imposes a submit time of day requirement on triggered-job. When used, the job is not submitted before this time.
    The triggered-job-submit-time is always rounded down to 15-minute increments.
    Default: 0 (no specific submit time requirement)
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400.
    Note: If triggered-job-queue-time is used, the date for the submit time requirement is the same as the deadline start date.

    If triggered-job-due-out-time is used and the triggered-job-submit-time is less than the triggered-job-due-out-time, the date for the triggered-job-submit-time is the same as the deadline start date. Otherwise, the triggered-job-submit-time date is the previous day.

#### Required Options

- `--triggered-job` | `--tj` (string)

  - Specifies the job name that the completion of the triggering dataset triggers.
    Limits: 1 to 8 alphanumeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates dataset trigger definition for triggered job JOBA:

  - `zowe ca7 dataset post-trigger_1 --tj JOBA`

### zowe › ca7 › dataset › rename-dataset

Change the name of a dataset in a dataset definition

#### Usage

zowe ca7 dataset rename-dataset [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--new-dataset-name` | `--ndn` (string)

  - Specifies the new, fully qualified data set name.
    Limits: 1 to 44 alphanumeric characters
    Note: new-dataset-name is not required to conform to MVS data set name standards. Embedded blanks and special characters such as slashes, dashes, and underscores are permitted. All alphabetic characters are uppercased.

#### Options

- `--dataset-name` | `--dname` (string)

  - (Required if dataset-number is omitted) Specifies the data set and must be the fully qualified data set name.
    Limits: 1 to 44 alphanumeric characters
    Note: dataset-name is not required to conform to MVS data set name standards. Embedded blanks and special characters such as slashes, dashes, and underscores are permitted. All alphabetic characters are uppercased.

- `--dataset-number` | `--dnum` (string)

  - (Required if dataset-name is omitted) Specifies the data set to use. The value must be the numeric value that CA 7 already assigned.
    Limits: 1 to 8 numeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Renames Dataset with name DATASET.NAME.TEST to NEW.DATASET.NAME.TEST on Instance1:

  - `zowe ca7 dataset rename-dataset --ca7Id Instance1 --dname DATASET.NAME.TEST --ndn NEW.DATASET.NAME.TEST`

### zowe › ca7 › dataset › rename-dataset › 1

Change the name of a dataset in a dataset definition

#### Usage

zowe ca7 dataset rename-dataset_1 [options]

#### Options

- `--dataset-name` | `--dname` (string)

  - (Required if dataset-number is omitted) Specifies the data set and must be the fully qualified data set name.
    Limits: 1 to 44 alphanumeric characters
    Note: dataset-name is not required to conform to MVS data set name standards. Embedded blanks and special characters such as slashes, dashes, and underscores are permitted. All alphabetic characters are uppercased.

- `--dataset-number` | `--dnum` (string)

  - (Required if dataset-name is omitted) Specifies the data set to use. The value must be the numeric value that CA 7 already assigned.
    Limits: 1 to 8 numeric characters

#### Required Options

- `--new-dataset-name` | `--ndn` (string)

  - Specifies the new, fully qualified data set name.
    Limits: 1 to 44 alphanumeric characters
    Note: new-dataset-name is not required to conform to MVS data set name standards. Embedded blanks and special characters such as slashes, dashes, and underscores are permitted. All alphabetic characters are uppercased.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Renames Dataset with name DATASET.NAME.TEST to NEW.DATASET.NAME.TEST:

  - `zowe ca7 dataset rename-dataset_1 --dname DATASET.NAME.TEST --ndn NEW.DATASET.NAME.TEST`

### zowe › ca7 › dataset › update-dataset

Modify the definition of a dataset

#### Usage

zowe ca7 dataset update-dataset [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--dataset-name` | `--dname` (string)

  - (Required if dataset-number is omitted) Specifies the data set and must be the fully qualified data set name.
    Limits: 1 to 44 alphanumeric characters
    Note: dataset-name is not required to conform to MVS data set name standards. Embedded blanks and special characters such as slashes, dashes, and underscores are permitted. All alphabetic characters are uppercased.

- `--dataset-number` | `--dnum` (string)

  - (Required if dataset-name is omitted) Specifies the data set to use. The value must be the numeric value that CA 7 already assigned.
    Limits: 1 to 8 numeric characters

- `--type` (string)

  - (Optional) Specifies the data set type.
    Valid values are:
    NORM = Internal means both the creating-job and using-jobs for this data set are known to CA 7.
    External means the creating-job, using-jobs, or both for this data set are not known to CA 7.PERM = Specifies this data set is always available for inputDefault: NORM
    Note: When a data set is marked PERM, no SMF records are captured. PERM means no data set triggering can occur with this type of data set

- `--gdg` (string)

  - (Optional) Specifies whether this data set is a generation data group.
    Valid values are:
    Y = The data set is a generation data groupN = The data set is not a generation data groupDefault: N
    Note: The specific GDG creations cannot be used for posting requirements or for triggering jobs. Posting and triggering are done based on the creation/updating (SMF 15 record) of any generation of the GDG.

- `--smf-feedback-required` | `--sfr` (string)

  - (Optional) Specifies whether the interface to System Management Facility (SMF) inserts the values for DSORG, RECFM, LRECL, and BLKSIZE when this data set is next used. Unless the value is reset, this insertion is only done once.
    Valid values are:
    Y = SMF inserts the values when the data set is next usedN = SMF does not insert the values when the data set is next usedDefault: Y
    Note: After the first time the job that creates this data set runs under CA 7, this field is reset to N. If the data set attributes change, this field must be reset to Y. The changed attribute field (that is, DSORG, RECFM) must be zeroed (if numeric) or blanked out. This process causes CA 7 to record the new values when the job is run again.

- `--post-at-close-time` | `--pact` (string)

  - (Optional) Specifies when to post the creation or update of a data set to the database and queues. This process does not ensure successful step or job termination.
    Valid values are:
    Y = The action takes place when the SMF data set creation record is received (when the data set is closed)N = Causes triggering or posting action to take place at the job terminationDefault: N

- `--device` (string)

  - (Optional) Specifies a device type.
    Valid values are:
    TAPEDASD

- `--dsorg` (string)

  - (Optional) Specifies the data set organization. This value is the same as the DSORG specified in the DCB subparameter in the JCL.
    Limits: 1 to 3 alphanumeric characters

- `--recfm` (string)

  - (Optional) Specifies the record format of the data set. This value is the same as the RECFM specified in the DCB subparameter in the JCL.
    Limits: 1 to 5 alphanumeric characters

- `--lrecl` (string)

  - (Optional) Specifies the logical record length of the data set. This value is the same as the LRECL specified in the DCB subparameter in the JCL.
    Limits: 1 to 5 numeric characters

- `--blksize` (string)

  - (Optional) Specifies the block size of the data set. This value is the same as the BLKSIZE specified in the DCB subparameter in the JCL.
    Limits: 1 to 5 numeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates the dataset with specified information on Instance1:

  - `zowe ca7 dataset update-dataset --ca7Id Instance1 --dname DATASET.NAME.TEST --type NORM --gdg N --sfr Y --pact N --blksize 11111`

### zowe › ca7 › dataset › update-dataset › 1

Modify the definition of a dataset

#### Usage

zowe ca7 dataset update-dataset_1 [options]

#### Options

- `--dataset-name` | `--dname` (string)

  - (Required if dataset-number is omitted) Specifies the data set and must be the fully qualified data set name.
    Limits: 1 to 44 alphanumeric characters
    Note: dataset-name is not required to conform to MVS data set name standards. Embedded blanks and special characters such as slashes, dashes, and underscores are permitted. All alphabetic characters are uppercased.

- `--dataset-number` | `--dnum` (string)

  - (Required if dataset-name is omitted) Specifies the data set to use. The value must be the numeric value that CA 7 already assigned.
    Limits: 1 to 8 numeric characters

- `--type` (string)

  - (Optional) Specifies the data set type.
    Valid values are:
    NORM = Internal means both the creating-job and using-jobs for this data set are known to CA 7.
    External means the creating-job, using-jobs, or both for this data set are not known to CA 7.PERM = Specifies this data set is always available for inputDefault: NORM
    Note: When a data set is marked PERM, no SMF records are captured. PERM means no data set triggering can occur with this type of data set

- `--gdg` (string)

  - (Optional) Specifies whether this data set is a generation data group.
    Valid values are:
    Y = The data set is a generation data groupN = The data set is not a generation data groupDefault: N
    Note: The specific GDG creations cannot be used for posting requirements or for triggering jobs. Posting and triggering are done based on the creation/updating (SMF 15 record) of any generation of the GDG.

- `--smf-feedback-required` | `--sfr` (string)

  - (Optional) Specifies whether the interface to System Management Facility (SMF) inserts the values for DSORG, RECFM, LRECL, and BLKSIZE when this data set is next used. Unless the value is reset, this insertion is only done once.
    Valid values are:
    Y = SMF inserts the values when the data set is next usedN = SMF does not insert the values when the data set is next usedDefault: Y
    Note: After the first time the job that creates this data set runs under CA 7, this field is reset to N. If the data set attributes change, this field must be reset to Y. The changed attribute field (that is, DSORG, RECFM) must be zeroed (if numeric) or blanked out. This process causes CA 7 to record the new values when the job is run again.

- `--post-at-close-time` | `--pact` (string)

  - (Optional) Specifies when to post the creation or update of a data set to the database and queues. This process does not ensure successful step or job termination.
    Valid values are:
    Y = The action takes place when the SMF data set creation record is received (when the data set is closed)N = Causes triggering or posting action to take place at the job terminationDefault: N

- `--device` (string)

  - (Optional) Specifies a device type.
    Valid values are:
    TAPEDASD

- `--dsorg` (string)

  - (Optional) Specifies the data set organization. This value is the same as the DSORG specified in the DCB subparameter in the JCL.
    Limits: 1 to 3 alphanumeric characters

- `--recfm` (string)

  - (Optional) Specifies the record format of the data set. This value is the same as the RECFM specified in the DCB subparameter in the JCL.
    Limits: 1 to 5 alphanumeric characters

- `--lrecl` (string)

  - (Optional) Specifies the logical record length of the data set. This value is the same as the LRECL specified in the DCB subparameter in the JCL.
    Limits: 1 to 5 numeric characters

- `--blksize` (string)

  - (Optional) Specifies the block size of the data set. This value is the same as the BLKSIZE specified in the DCB subparameter in the JCL.
    Limits: 1 to 5 numeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates the dataset with specified information:

  - `zowe ca7 dataset update-dataset_1 --dname DATASET.NAME.TEST --type NORM --gdg N --sfr Y --pact N --blksize 11111`

### zowe › ca7 › dataset › update-trigger

Modify a Dataset Trigger definition

#### Usage

zowe ca7 dataset update-trigger [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--triggered-job` | `--tj` (string)

  - Specifies the job name that the completion of the triggering dataset triggers.
    Limits: 1 to 8 alphanumeric characters

#### Options

- `--dataset-name` | `--dname` (string)

  - (Required if dataset-number is omitted) Specifies the data set name whose creation/update causes triggering of a job.
    Note: For VSAM files, specify the cluster name.
    Limits: 1 to 44 alphanumeric characters

- `--dataset-number` | `--dnum` (string)

  - (Required if dataset-name is omitted) Specifies the existing data set number whose creation causes triggering. The number is the value that CA 7 assigned to the data set.
    Limits: 1 to 8 numeric characters

- `--schid` (string)

  - (Optional) Specifies for which schedule ID of the triggering dataset the triggered-job is scheduled.
    Note: If the data set is one that is tracked with use of SASSXDSN (externally tracked data sets), the schid field must be 000 for the trigger to work
    Default: 0 (all schedule IDs)
    Limits: 1 to 3 numeric characters from 0 through 999

- `--triggered-job-schid` | `--tjs` (string)

  - (Optional) Denotes a replacement schedule ID to use when the triggered-job is placed into the request queue.
    Default: 0 (no replacement)
    Limits: 1 to 3 numeric characters from 0 through 999
    Note: If triggered-job-schid is used, it replaces the schid value of the triggered job. Any jobs triggered (by triggered-job or data sets it creates) use this triggered-job-schid for their schedule ID unless they also have a triggered-job-schid value.

- `--triggered-job-due-out-time` | `--tjdot` (string)

  - (Required if triggered-job-queue-time is omitted) Specifies the due-out time of day of the triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-queue-time must be omitted.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400. If specified, the lowest value is 10.
    Note: If used and the due-out-time of the triggering job is after the triggered-job-due-out-time, the following calendar day is assumed.

- `--triggered-job-queue-time` | `--tjqt` (string)

  - (Required if triggered-job-due-out-time is omitted) Specifies the elapsed queue time of triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-due-out-time must be omitted because due-out time is then calculated as deadline time plus runtime.
    Deadline time is calculated as current date/time plus queue time.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-lead-time` | `--tjlt` (string)

  - (Optional) Specifies the elapsed lead time for triggered-job rounded to 10-minute increments. This parameter specifies the lead or processing time necessary to ensure triggered-job meets its due-out time.
    Default: 0000
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-submit-time` | `--tjst` (string)

  - (Optional) Imposes a submit time of day requirement on triggered-job. When used, the job is not submitted before this time.
    The triggered-job-submit-time is always rounded down to 15-minute increments.
    Default: 0 (no specific submit time requirement)
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400.
    Note: If triggered-job-queue-time is used, the date for the submit time requirement is the same as the deadline start date.

    If triggered-job-due-out-time is used and the triggered-job-submit-time is less than the triggered-job-due-out-time, the date for the triggered-job-submit-time is the same as the deadline start date. Otherwise, the triggered-job-submit-time date is the previous day.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes dataset trigger definition for triggered job JOBA on Instance1:

  - `zowe ca7 dataset update-trigger --ca7Id Instance1 --tj JOBA`

### zowe › ca7 › dataset › update-trigger › 1

Modify a Dataset Trigger definition

#### Usage

zowe ca7 dataset update-trigger_1 [options]

#### Options

- `--dataset-name` | `--dname` (string)

  - (Required if dataset-number is omitted) Specifies the data set name whose creation/update causes triggering of a job.
    Note: For VSAM files, specify the cluster name.
    Limits: 1 to 44 alphanumeric characters

- `--dataset-number` | `--dnum` (string)

  - (Required if dataset-name is omitted) Specifies the existing data set number whose creation causes triggering. The number is the value that CA 7 assigned to the data set.
    Limits: 1 to 8 numeric characters

- `--schid` (string)

  - (Optional) Specifies for which schedule ID of the triggering dataset the triggered-job is scheduled.
    Note: If the data set is one that is tracked with use of SASSXDSN (externally tracked data sets), the schid field must be 000 for the trigger to work
    Default: 0 (all schedule IDs)
    Limits: 1 to 3 numeric characters from 0 through 999

- `--triggered-job-schid` | `--tjs` (string)

  - (Optional) Denotes a replacement schedule ID to use when the triggered-job is placed into the request queue.
    Default: 0 (no replacement)
    Limits: 1 to 3 numeric characters from 0 through 999
    Note: If triggered-job-schid is used, it replaces the schid value of the triggered job. Any jobs triggered (by triggered-job or data sets it creates) use this triggered-job-schid for their schedule ID unless they also have a triggered-job-schid value.

- `--triggered-job-due-out-time` | `--tjdot` (string)

  - (Required if triggered-job-queue-time is omitted) Specifies the due-out time of day of the triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-queue-time must be omitted.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400. If specified, the lowest value is 10.
    Note: If used and the due-out-time of the triggering job is after the triggered-job-due-out-time, the following calendar day is assumed.

- `--triggered-job-queue-time` | `--tjqt` (string)

  - (Required if triggered-job-due-out-time is omitted) Specifies the elapsed queue time of triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-due-out-time must be omitted because due-out time is then calculated as deadline time plus runtime.
    Deadline time is calculated as current date/time plus queue time.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-lead-time` | `--tjlt` (string)

  - (Optional) Specifies the elapsed lead time for triggered-job rounded to 10-minute increments. This parameter specifies the lead or processing time necessary to ensure triggered-job meets its due-out time.
    Default: 0000
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-submit-time` | `--tjst` (string)

  - (Optional) Imposes a submit time of day requirement on triggered-job. When used, the job is not submitted before this time.
    The triggered-job-submit-time is always rounded down to 15-minute increments.
    Default: 0 (no specific submit time requirement)
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400.
    Note: If triggered-job-queue-time is used, the date for the submit time requirement is the same as the deadline start date.

    If triggered-job-due-out-time is used and the triggered-job-submit-time is less than the triggered-job-due-out-time, the date for the triggered-job-submit-time is the same as the deadline start date. Otherwise, the triggered-job-submit-time date is the previous day.

#### Required Options

- `--triggered-job` | `--tj` (string)

  - Specifies the job name that the completion of the triggering dataset triggers.
    Limits: 1 to 8 alphanumeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates dataset trigger definition for triggered job JOBA:

  - `zowe ca7 dataset update-trigger_1 --tj JOBA`

## zowe › ca7 › job-definition

All the available commands listed in the Job Definition section.

### zowe › ca7 › job-definition › delete-address-space-resource

Delete an Address Space resource from the definition of a job

#### Usage

zowe ca7 job-definition delete-address-space-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes a job named JOBA with resource name RESOURCE.NAME for INSTANCE1:

  - `zowe ca7 job-definition delete-address-space-resource --job JOBA --rn RESOURCE.NAME --schid 42 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › delete-address-space-resource › 1

Delete an Address Space resource from the definition of a job

#### Usage

zowe ca7 job-definition delete-address-space-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes a job named JOBA with resource name RESOURCE.NAME:

  - `zowe ca7 job-definition delete-address-space-resource_1 --job JOBA --rn RESOURCE.NAME --schid 42`

### zowe › ca7 › job-definition › delete-corequisite-resource

Delete a Corequisite resource from the definition of a job

#### Usage

zowe ca7 job-definition delete-corequisite-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job-name` | `--jn` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be nonblank, and no embedded blanks
    Exception: If the resource connection is made to a resource count resource,
    the resource name can be from 1 to 39 characters followed by a / (slash) and
    a 1 through 4 numeric value indicating the number of occurrences for the resource that the job uses.

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for
    a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message that is issued.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes a job named JOBA with resource name RESOURCE.NAME and schid 42 for INSTANCE1:

  - `zowe ca7 job-definition delete-corequisite-resource --jn JOBA --rn RESOURCE.NAME --schid 42 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › delete-corequisite-resource › 1

Delete a Corequisite resource from the definition of a job

#### Usage

zowe ca7 job-definition delete-corequisite-resource_1 [options]

#### Required Options

- `--job-name` | `--jn` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be nonblank, and no embedded blanks
    Exception: If the resource connection is made to a resource count resource,
    the resource name can be from 1 to 39 characters followed by a / (slash) and
    a 1 through 4 numeric value indicating the number of occurrences for the resource that the job uses.

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for
    a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message that is issued.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes a job named JOBA with resource name RESOURCE.NAME and schid 42:

  - `zowe ca7 job-definition delete-corequisite-resource_1 --jn JOBA --rn RESOURCE.NAME --schid 42`

### zowe › ca7 › job-definition › delete-exclusive-resource

Delete an Exclusive resource from the definition of a job

#### Usage

zowe ca7 job-definition delete-exclusive-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes a job named JOBA with resource name RESOURCE.NAME for INSTANCE1:

  - `zowe ca7 job-definition delete-exclusive-resource --job JOBA --rn RESOURCE.NAME --schid 42 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › delete-exclusive-resource › 1

Delete an Exclusive resource from the definition of a job

#### Usage

zowe ca7 job-definition delete-exclusive-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes a job named JOBA with resource name RESOURCE.NAME:

  - `zowe ca7 job-definition delete-exclusive-resource_1 --job JOBA --rn RESOURCE.NAME --schid 42`

### zowe › ca7 › job-definition › delete-job

Delete Job Definition

#### Usage

zowe ca7 job-definition delete-job [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - The name of the job

- `--type` (string)

  - The type of deletion.
    Valid values are:
    DELETE
    Deletes a job and its associated data from the database (documentation, schedules, and so forth).DD
    Same as DELETE, but deletes any data sets that this job references if the data sets have no users and
    no documentation, and do not cause job triggering.
    This includes all virtual resources that are connected to the job.PURGE
    Same as DD, but also deletes job trigger definitions that trigger the job being deleted,
    job requirement definitions that require the job being deleted;
    and, if the WA Restart_XXX Option interface is active, deletes the WA Restart_XXX Option
    CMT member for the job being deleted.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Delete Job named JOBA for INSTANCE1:

  - `zowe ca7 job-definition delete-job --job JOBA --type DELETE --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › delete-job › 1

Delete Job Definition

#### Usage

zowe ca7 job-definition delete-job_1 [options]

#### Required Options

- `--job` (string)

  - The name of the job

- `--type` (string)

  - The type of deletion.
    Valid values are:
    DELETE
    Deletes a job and its associated data from the database (documentation, schedules, and so forth).DD
    Same as DELETE, but deletes any data sets that this job references if the data sets have no users and
    no documentation, and do not cause job triggering.
    This includes all virtual resources that are connected to the job.PURGE
    Same as DD, but also deletes job trigger definitions that trigger the job being deleted,
    job requirement definitions that require the job being deleted;
    and, if the WA Restart_XXX Option interface is active, deletes the WA Restart_XXX Option
    CMT member for the job being deleted.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Delete Job named JOBA:

  - `zowe ca7 job-definition delete-job_1 --job JOBA --type DELETE`

### zowe › ca7 › job-definition › delete-job-schedule

Delete an existing date/time schedule (remove a schedule ID) for a CA7 job

#### Usage

zowe ca7 job-definition delete-job-schedule [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - The name of the job

- `--schid` (string)

  - Specifies the numeric schedule ID on which the user wants to perform the specified action.
    Limits:
    1 to 3 numeric characters from 1 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Delete an existing date/time schedule (remove a schedule ID) for a CA7 job ZOWECRM1 for INSTANCE1:

  - `zowe ca7 job-definition delete-job-schedule --job ZOWECRM1 --schid 0004 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › delete-job-schedule › 1

Delete an existing date/time schedule (remove a schedule ID) for a CA7 job

#### Usage

zowe ca7 job-definition delete-job-schedule_1 [options]

#### Required Options

- `--job` (string)

  - The name of the job

- `--schid` (string)

  - Specifies the numeric schedule ID on which the user wants to perform the specified action.
    Limits:
    1 to 3 numeric characters from 1 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Delete an existing date/time schedule (remove a schedule ID) for a CA7 job ZOWECRM1:

  - `zowe ca7 job-definition delete-job-schedule_1 --job ZOWECRM1 --schid 0004`

### zowe › ca7 › job-definition › delete-requirement-predecessor

Delete predecessor requirement for a job.

#### Usage

zowe ca7 job-definition delete-requirement-predecessor [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - The name of the job that requires the predecessor

- `--schid` (string)

  - The schedule id of requiring job

- `--predtype` (string)

  - The predecessor type
    [ JOB, DSN, USER ]

- `--nextrun` (string)

  - The status of predecessor for next run of job
    [ YES, ONLY, SKIP ]

- `--predobject` | `--po` (string)

  - The predecessor. Values vary with predtype.
    When predtype:JOB, predobject is 1-8 character name of required job.
    When predtype:DSN,predobject is 1-44 name of required dataset.
    When predtype:USER then predobject is 1-44 character user requirement text.

#### Options

- `--leadtime` (string)

  - The satisfaction lead time in hours.
    This may be honored when predtype is job or DSN

- `--permanent` (string)

  - Indicates that this predecessor is permanent, that is always considered satisfied.
    This parameter only applies when predtype is DSN.
    [ Y, N ]

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Delete a job requirement predecessor of a CA 7 job using the options for INSTANCE1:

  - `zowe ca7 job-definition delete-requirement-predecessor --job ZOWECRM1 --schid 0004 --predtype USER --nextrun ONLY --predobject USER101 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › delete-requirement-predecessor › 1

Delete predecessor requirement for a job.

#### Usage

zowe ca7 job-definition delete-requirement-predecessor_1 [options]

#### Required Options

- `--job` (string)

  - The name of the job that requires the predecessor

- `--schid` (string)

  - The schedule id of requiring job

- `--predtype` (string)

  - The predecessor type
    [ JOB, DSN, USER ]

- `--nextrun` (string)

  - The status of predecessor for next run of job
    [ YES, ONLY, SKIP ]

- `--predobject` | `--po` (string)

  - The predecessor. Values vary with predtype.
    When predtype:JOB, predobject is 1-8 character name of required job.
    When predtype:DSN,predobject is 1-44 name of required dataset.
    When predtype:USER then predobject is 1-44 character user requirement text.

#### Options

- `--leadtime` (string)

  - The satisfaction lead time in hours.
    This may be honored when predtype is job or DSN

- `--permanent` (string)

  - Indicates that this predecessor is permanent, that is always considered satisfied.
    This parameter only applies when predtype is DSN.
    [ Y, N ]

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Delete a job requirement predecessor of a CA 7 job using the options:

  - `zowe ca7 job-definition delete-requirement-predecessor_1 --job ZOWECRM1 --schid 0004 --predtype USER --nextrun ONLY --predobject USER101`

### zowe › ca7 › job-definition › delete-resource-count-resource

Delete a Resource Count resource from the definition of a job

#### Usage

zowe ca7 job-definition delete-resource-count-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 39 characters, the first character must be non-blank, and no embedded blanks

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes a job named JOBA with resource name RESOURCE.NAME for INSTANCE1:

  - `zowe ca7 job-definition delete-resource-count-resource --job JOBA --rn RESOURCE.NAME --schid 42 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › delete-resource-count-resource › 1

Delete a Resource Count resource from the definition of a job

#### Usage

zowe ca7 job-definition delete-resource-count-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 39 characters, the first character must be non-blank, and no embedded blanks

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes a job named JOBA with resource name RESOURCE.NAME:

  - `zowe ca7 job-definition delete-resource-count-resource_1 --job JOBA --rn RESOURCE.NAME --schid 42`

### zowe › ca7 › job-definition › delete-shared-resource

Delete a Shared resource from the definition of a job

#### Usage

zowe ca7 job-definition delete-shared-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes a job named JOBAA with resource name SCHENV.VARNAME on INSTANCE1:

  - `zowe ca7 job-definition delete-shared-resource --job JOBAA --schid 23 --rn SCHENV.VARNAME --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › delete-shared-resource › 1

Delete a Shared resource from the definition of a job

#### Usage

zowe ca7 job-definition delete-shared-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes a job named JOBAA with resource name SCHENV.VARNAME:

  - `zowe ca7 job-definition delete-shared-resource_1 --job JOBAA --schid 23 --rn SCHENV.VARNAME`

### zowe › ca7 › job-definition › delete-trigger-successor

Delete a Job Trigger from the definition of a job

#### Usage

zowe ca7 job-definition delete-trigger-successor [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name whose successful completion causes triggering.
    Limits: 1 to 8 alphanumeric characters

- `--triggered-job` | `--tj` (string)

  - Specifies the job name that the completion of the triggering job triggers.
    Limits: 1 to 8 alphanumeric characters

#### Options

- `--schid` (string)

  - (Optional) Specifies for which schedule ID of the triggering job the triggered-job is scheduled.
    Default: 0 (all schedule IDs)
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Delete a Job Trigger JOBB from the definition of JOBA for INSTANCE1:

  - `zowe ca7 job-definition delete-trigger-successor --job JOBA --tj JOBB --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › delete-trigger-successor › 1

Delete a Job Trigger from the definition of a job

#### Usage

zowe ca7 job-definition delete-trigger-successor_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name whose successful completion causes triggering.
    Limits: 1 to 8 alphanumeric characters

- `--triggered-job` | `--tj` (string)

  - Specifies the job name that the completion of the triggering job triggers.
    Limits: 1 to 8 alphanumeric characters

#### Options

- `--schid` (string)

  - (Optional) Specifies for which schedule ID of the triggering job the triggered-job is scheduled.
    Default: 0 (all schedule IDs)
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Delete a Job Trigger JOBB from the definition of JOBA:

  - `zowe ca7 job-definition delete-trigger-successor_1 --job JOBA --tj JOBB`

### zowe › ca7 › job-definition › delete-variable-resource

Delete a Variable resource from the definition of a job

#### Usage

zowe ca7 job-definition delete-variable-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: "SCHENV." followed by 1 to 16 alphanumeric and @, #, $, _ characters

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes a job named JOBAA with resource name SCHENV.VARNAME for INSTANCE1:

  - `zowe ca7 job-definition delete-variable-resource --job JOBAA --schid 23 --rn SCHENV.VARNAME --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › delete-variable-resource › 1

Delete a Variable resource from the definition of a job

#### Usage

zowe ca7 job-definition delete-variable-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: "SCHENV." followed by 1 to 16 alphanumeric and @, #, $, _ characters

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Deletes a job named JOBAA with resource name SCHENV.VARNAME:

  - `zowe ca7 job-definition delete-variable-resource_1 --job JOBAA --schid 23 --rn SCHENV.VARNAME`

### zowe › ca7 › job-definition › list-job

List Job Definiton

#### Usage

zowe ca7 job-definition list-job [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--jobname` | `--jn` (string)

  - The CA 7 job name

- `--all` (boolean)

  - Fetch all the available properties

    Default value: false

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Lists details of job named JOBA for INSTANCE1:

  - `zowe ca7 job-definition list-job --jobname JOBA --all true --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › list-job › 1

List Job Definiton

#### Usage

zowe ca7 job-definition list-job_1 [options]

#### Required Options

- `--jobname` | `--jn` (string)

  - The CA 7 job name

- `--all` (boolean)

  - Fetch all the available properties

    Default value: false

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Lists details of job named JOBA:

  - `zowe ca7 job-definition list-job_1 --jobname JOBA --all true`

### zowe › ca7 › job-definition › list-job-resources

Get a list of the job resources for one or more jobs

#### Usage

zowe ca7 job-definition list-job-resources [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the job resources for JOBA on INSTANCE1:

  - `zowe ca7 job-definition list-job-resources --jobname JOBA --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › list-job-resources › 1

Get a list of the job resources for one or more jobs

#### Usage

zowe ca7 job-definition list-job-resources_1 [options]

#### Required Options

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the job resources for JOBA:

  - `zowe ca7 job-definition list-job-resources_1 --jobname JOBA`

### zowe › ca7 › job-definition › list-job-schedules

Get a list of the job schedules for one or more jobs

#### Usage

zowe ca7 job-definition list-job-schedules [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the job resources for JOBA on INSTANCE1:

  - `zowe ca7 job-definition list-job-schedules --jobname JOBA --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › list-job-schedules › 1

Get a list of the job schedules for one or more jobs

#### Usage

zowe ca7 job-definition list-job-schedules_1 [options]

#### Required Options

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the job schedules for JOBA:

  - `zowe ca7 job-definition list-job-schedules_1 --jobname JOBA`

### zowe › ca7 › job-definition › list-requirement-predecessor

Get a list of the predecessors for one or more jobs

#### Usage

zowe ca7 job-definition list-requirement-predecessor [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the predecessors for TESTJOB on INSTANCE1:

  - `zowe ca7 job-definition list-requirement-predecessor --jobname TESTJOB --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › list-requirement-predecessor › 1

Get a list of the predecessors for one or more jobs

#### Usage

zowe ca7 job-definition list-requirement-predecessor_1 [options]

#### Required Options

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the predecessors for TESTJOB:

  - `zowe ca7 job-definition list-requirement-predecessor_1 --jobname TESTJOB`

### zowe › ca7 › job-definition › list-requirement-successor

Get a list of the successor jobs for one or more jobs

#### Usage

zowe ca7 job-definition list-requirement-successor [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the successor jobs for JOBA on INSTANCE1:

  - `zowe ca7 job-definition list-requirement-successor --jobname JOBA --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › list-requirement-successor › 1

Get a list of the successor jobs for one or more jobs

#### Usage

zowe ca7 job-definition list-requirement-successor_1 [options]

#### Required Options

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the successor jobs for JOBA on INSTANCE1:

  - `zowe ca7 job-definition list-requirement-successor_1 --jobname JOBA --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › list-trigger-successor

Get Job Trigger Successor

#### Usage

zowe ca7 job-definition list-trigger-successor [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the triggered jobs for JOBA for INSTANCE1:

  - `zowe ca7 job-definition list-trigger-successor --jobname JOBA --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › list-trigger-successor › 1

Get Job Trigger Successor

#### Usage

zowe ca7 job-definition list-trigger-successor_1 [options]

#### Required Options

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the triggered jobs for JOBA:

  - `zowe ca7 job-definition list-trigger-successor_1 --jobname JOBA`

### zowe › ca7 › job-definition › post-address-space-resource

Add an Address Space resource to the definition of a job

#### Usage

zowe ca7 job-definition post-address-space-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--ready-when` | `--rw` (string)

  - (Optional) Determines how VRM manages resource availability at job submission and job/step completion.
    Default: A
    Valid values are:
    A = Specifies the job is submitted only if the resource is active on the same system as CA 7. The resource name is assumed to be a jobname or started task name running on the systemI = Specifies the job is submitted only if the resource is not active on the same system as CA 7. The resource name is assumed to be a jobname or started task name running on the system

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates a job named JOBAA with resource name SCHENV.VARNAME, schedule id 23 and job is submitted only if the resource is not active for INSTANCE1:

  - `zowe ca7 job-definition post-address-space-resource --job JOBAA --schid 23 --rn SCHENV.VARNAME --rw I --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › post-address-space-resource › 1

Add an Address Space resource to the definition of a job

#### Usage

zowe ca7 job-definition post-address-space-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--ready-when` | `--rw` (string)

  - (Optional) Determines how VRM manages resource availability at job submission and job/step completion.
    Default: A
    Valid values are:
    A = Specifies the job is submitted only if the resource is active on the same system as CA 7. The resource name is assumed to be a jobname or started task name running on the systemI = Specifies the job is submitted only if the resource is not active on the same system as CA 7. The resource name is assumed to be a jobname or started task name running on the system

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates a job named JOBAA with resource name SCHENV.VARNAME, schedule id 23 and job is submitted only if the resource is not active:

  - `zowe ca7 job-definition post-address-space-resource_1 --job JOBAA --schid 23 --rn SCHENV.VARNAME --rw I`

### zowe › ca7 › job-definition › post-corequisite-resource

Add a Corequisite resource to the definition of a job

#### Usage

zowe ca7 job-definition post-corequisite-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job-name` | `--jn` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be nonblank, and no embedded blanks
    Exception: If the resource connection is made to a resource count resource, the resource name can be from 1 to 39 characters followed by a / (slash)
    and a 1 through 4 numeric value indicating the number of occurrences for the resource that the job uses.

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message that is issued.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--ready-when` | `--rw` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Default: A
    Valid values are:
    A = Specifies the job is submitted only if the resource is active (as established by the PRSQA command).
    I = Specifies the job is submitted only if the resource is not active.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates a job named JOBAA with resource name SCHENV.VARNAME, schedule id 23 and job is submitted only if the resource is not active for INSTANCE1:

  - `zowe ca7 job-definition post-corequisite-resource --jn JOBAA --schid 23 --rn SCHENV.VARNAME --rw I --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › post-corequisite-resource › 1

Add a Corequisite resource to the definition of a job

#### Usage

zowe ca7 job-definition post-corequisite-resource_1 [options]

#### Required Options

- `--job-name` | `--jn` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be nonblank, and no embedded blanks
    Exception: If the resource connection is made to a resource count resource, the resource name can be from 1 to 39 characters followed by a / (slash)
    and a 1 through 4 numeric value indicating the number of occurrences for the resource that the job uses.

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message that is issued.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--ready-when` | `--rw` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Default: A
    Valid values are:
    A = Specifies the job is submitted only if the resource is active (as established by the PRSQA command).
    I = Specifies the job is submitted only if the resource is not active.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates a job named JOBAA with resource name SCHENV.VARNAME, schedule id 23 and job is submitted only if the resource is not active:

  - `zowe ca7 job-definition post-corequisite-resource_1 --jn JOBAA --schid 23 --rn SCHENV.VARNAME --rw I`

### zowe › ca7 › job-definition › post-exclusive-resource

Add an Exclusive resource to the definition of a job

#### Usage

zowe ca7 job-definition post-exclusive-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

- `--free` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Valid values are:
    A = Specifies the resource is only freed if any step in the job abends (abend or condition code checking)
    F = Specifies the resource is freed when job ends, either successfully or unsuccessfully. If the step-name parameter is specified, free the resource when the specified step completes, either successfully or unsuccessfully
    N = Specifies do not free the resource at successful job completion. The resource can be freed with the PRSCF command. A cancel of the job also frees the resource
    Y = Specifies to free the resource at successful job completion. If the step-name parameter is specified, free the resource when the specified step completes successfully (does not abend)

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--step-name` | `--sn` (string)

  - (Optional) Specifies the resource is freed at the conclusion of the named job step.
    Limits: 1 to 8 alphanumeric characters
    Notes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream. This includes any reference to the stepname embedded in a PROCThe only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROCIf a job is restarted in a step after this step-name, the resource does not go through free processing until the job completesA step flush condition does not post the step-name process

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates a job named JOBAA with resource name SCHENV.VARNAME of free type F, step name JS010 and schedule id 23 for INSTANCE1:

  - `zowe ca7 job-definition post-exclusive-resource --job JOBAA --schid 23 --rn SCHENV.VARNAME --free F --sn JS010 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › post-exclusive-resource › 1

Add an Exclusive resource to the definition of a job

#### Usage

zowe ca7 job-definition post-exclusive-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

- `--free` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Valid values are:
    A = Specifies the resource is only freed if any step in the job abends (abend or condition code checking)
    F = Specifies the resource is freed when job ends, either successfully or unsuccessfully. If the step-name parameter is specified, free the resource when the specified step completes, either successfully or unsuccessfully
    N = Specifies do not free the resource at successful job completion. The resource can be freed with the PRSCF command. A cancel of the job also frees the resource
    Y = Specifies to free the resource at successful job completion. If the step-name parameter is specified, free the resource when the specified step completes successfully (does not abend)

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--step-name` | `--sn` (string)

  - (Optional) Specifies the resource is freed at the conclusion of the named job step.
    Limits: 1 to 8 alphanumeric characters
    Notes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream. This includes any reference to the stepname embedded in a PROCThe only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROCIf a job is restarted in a step after this step-name, the resource does not go through free processing until the job completesA step flush condition does not post the step-name process

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates a job named JOBAA with resource name SCHENV.VARNAME of free type F, step name JS010 and schedule id 23:

  - `zowe ca7 job-definition post-exclusive-resource_1 --job JOBAA --schid 23 --rn SCHENV.VARNAME --free F --sn JS010`

### zowe › ca7 › job-definition › post-job

Create Job Definition

#### Usage

zowe ca7 job-definition post-job [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - The name of the job

- `--job-type` | `--jt` (string)

  - The type of job.
    Valid values are:
    CPU = A CPU jobXPJOB = A cross-platform jobAGENT = An Agent job

#### Options

- `--long-name` | `--ln` (string)

  - (Optional) Defines the long job name.
    Limits: 1 to 64 alphanumeric characters, case sensitive

- `--system` (string)

  - (Optional) Specifies the user-defined application system name of which this job is a part.
    Limits: 1 to 8 alphanumeric characters. This field cannot contain a comma

- `--uid` (string)

  - (Optional) Specifies the CA 7 user security identification.
    Default: 0 (no internal security protection)
    Limits: 1 to 3 numeric characters from 0 through 999

- `--jobnet` (string)

  - (Optional) Specifies the name of a CPU job network of which this job is a part.
    Limits: 1 to 8 alphanumeric characters. This field cannot contain a comma

- `--owner` (string)

  - (Optional) Specifies the ID identifying ownership of this job. Depending on the startup options taken, the external security product being used and contents of the JCL, this value can be offered to the external security package by CA 7 at job submission time as the authority for this job to be executed.
    Limits: 1 to 8 alphanumeric characters. Although this field supports up to 8 characters, some external security packages only accept up to 7 characters. This field must not exceed any such limit that exists

- `--jcl-member` | `--jm` (string)

  - (Optional) Specifies the JCL library member name and required when the member name and job name are different.
    Valid when: job-type is CPU
    Default: Job name
    Limits: 1 to 8 alphanumeric characters

- `--id` (string)

  - (Optional) Specifies a numeric index value that is associated with a JCL library where the JCL member is located. NOTE: the id and lib properties are mutually exclusive.
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0-253 or 256-999

- `--lib` (string)

  - (Optional) Specifies a JCL library identification consisting of a symbolic INDEX assigned to a JCL statement. NOTE: the id and lib properties are mutually exclusive.
    Valid when: job-type is CPU
    Limits: 2 to 16 alphanumeric characters beginning with ampersand (&)

- `--reload` (string)

  - (Optional) Specifies whether to reload the JCL of this job. When a job comes into the request queue, it is either flagged for load processing or it is not flagged.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = The job is flagged for load processing. The reload flag is automatically reset to N once the load completes successfullyN = The job is not flagged for load processing unless it is the first time it has run in CA 7X = The job is only flagged for load processing when the LOAD command is used and is never automatically changed even if the LOAD command is used

- `--execute` (string)

  - (Optional) Indicates whether to execute this job.
    Default: Y
    Valid values are:
    Y = The job will be executedN = The job does not run but shows a normal completion as if it did run. JCL is not required for non-executable jobs

- `--retain` (string)

  - (Optional) Specifies whether to retain the execution JCL in the trailer queue after a successful run.
    Valid when: job-type is CPU or XPJOB
    Default: N
    Valid values are:
    Y = Retain the JCL in the trailer queue after a successful run.N = Do not retain the JCL in the trailer queue after a successful run

- `--hold` (string)

  - (Optional) Specifies whether to place this job in a hold status when it enters the request queue.
    Default: N
    Valid values are:
    Y = The job will be heldN = The job will not be held

- `--jcl-override` | `--jo` (string)

  - (Optional) Specifies whether this job needs manual JCL overrides before it can be submitted. Similar to the JCLOVRD command.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = The job needs manual JCL overrides before it can be submittedN = The job does not need manual JCL overrides before it can be submitted

- `--use-jcl-override-library` | `--ujol` (string)

  - (Optional) Specifies whether to retrieve the JCL from the JCL Override library (JCLID=254) for the next run only. This field is automatically set back to N the next time the job comes into the request queue.
    Default: N
    Valid values are:
    Y = The JCL is retrieved from the JCL Override library for the next runN = The JCL is not retrieved from the JCL Override library for the next run

- `--verify` (string)

  - (Optional) Specifies whether this job requires any pre-submission manual verification. Similar to VERIFY command.
    Default: N
    Valid values are:
    Y = The job requires any pre-submission manual verificationN = The job does not require any pre-submission manual verification

- `--maintenance` | `--maint` (string)

  - (Optional) Specifies whether this job is a maintenance job (for example, a system utility) with no production data set requirements. If Y is specified, all input data set requirements are ignored. None of the output data sets created by this job is posted back to CA 7.
    Marking a job as maintenance enables job triggering but not data set triggering.
    Also, if the LOADDSNS keyword is used on the DBASE statement in the initialization file, the LOAD process does not build any DD or data set information for jobs that are marked as maintenance. This means that there are not any data set connections for these jobs unless added manually.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = The job is a maintenance jobN = The job is not a maintenance job

- `--job-requirement-lead-time` | `--jrlt` (string)

  - (Optional) Specifies the number of hours to be considered when satisfying job-dependent requirements.
    Default: 0
    Valid values are:
    0 = No lead time is considered when satisfying this job's requirements99 = Specifies the requirement is never considered as already satisfied when the job enters the queues. Each predecessor job must complete typically while this job is in the request queuenn = Since the last run of this job, specifies that each predecessor job must have run within the last nn hours. Values for nn can be from 1 to 98

- `--dataset-requirement-lead-time` | `--drlt` (string)

  - (Optional) Specifies the number of hours to be considered when satisfying data set requirements.
    Valid when: job-type is CPU
    Default: 0
    Valid values are:
    0 = No lead time is considered when satisfying this job's requirements99 = Specifies the requirement is never considered as already satisfied when the job enters the queues. Each data set requirement must be satisfied typically while this job is in the request queuenn = Since the last run of this job, specifies that each data set requirement must be satisfied within the last nn hours. Values for nn can be from 1 to 98

- `--arfset` (string)

  - (Optional) Names the collection of ARF definitions that apply to this job. Remember that ARF recovery is not invoked for non-executable jobs.
    Limits: 1 to 8 alphanumeric characters

- `--mainid` (string)

  - (Optional) Specifies on which CPU the job can or cannot be scheduled. If the job requirements impose CPU restrictions, specify SYn or /SYn where n is the system number and / indicates not this system. System numbers must be consistent with the initialization file CPU statement MAINIDS parameters.
    Valid when: job-type is CPU
    Default: ALL (lets the job run on any CPU)
    Limits: 1 to 4 alphanumeric characters

- `--insert-ca11-rms` | `--icr` (string)

  - (Optional) Specifies whether to insert the WA Restart_XXX Option RMS step automatically at execution time by CA 7.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = Inserts the step with the WA Restart_XXX Option processing code of PN = Does not insert the RMS step

- `--condition-code` | `--cc` (string)

  - (Optional) Used with relational-operator property to define the job-level condition codes used to determine whether a job executes successfully.
    Valid when: job-type is CPU or XPJOB
    Note: All condition codes that are returned from an XPJOB job are treated as positive values. Any negative value returned is converted to an absolute (positive) value
    Default: 0
    Limits: For job-type = CPU: 1 to 4 numeric characters in the range 0-4095
    For job-type = "XPJOB": 1 to 4 numeric characters in the range 0-9999

- `--relational-operator` | `--ro` (string)

  - (Optional) Specifies the relational operator of the condition-code property or if the step level #SCC statements are being used in the job's JCL.
    Valid when: job-type is CPU or XPJOB
    Default: 0
    Valid values are:
    EQ = Equal toLT = Less thanGT = Greater thanGE = Greater than or equal toLE = Less than or equal toNE = Not equal to#S = Make step condition code tests based on #SCC statements in the JCLIG = Make no evaluation of the job. CA 7 always assumes the job completes successfully, regardless of condition codes, abend codes, or runtime JCL errors. When this is used, the insert-ca11-rms property should be N0 = No condition test will be madeNOTE: If 0 is used, no test is made on the job's condition code. The highest condition code that this job generates is tested by this pair of parameters. For example, if condition-code is set at 8 and RO is set at LT, the job is marked as completing abnormally if 8 is less than the job's highest condition code

- `--do-not-schedule-before-date` | `--dnsbd` (string)

  - (Optional) Specifies not to schedule this job before this date (in YYDDD format, or 00000)

- `--do-not-schedule-before-time` | `--dnsbt` (string)

  - (Optional) Specifies not to schedule this job before this time (in HHMM format)

- `--do-not-schedule-after-date` | `--dnsad` (string)

  - (Optional) Specifies not to schedule this job after this date (in YYDDD format, or 99999)

- `--do-not-schedule-after-time` | `--dnsat` (string)

  - (Optional) Specifies not to schedule this job after this time (in HHMM format)

- `--lterm` (string)

  - (Optional) Routes the messages about this job to this logical terminal name.
    Default: If not entered, the LTERM associated with the JCL library in the initialization file JCL statement is used. If LTERM is not specified on the JCL statement, the default is MASTER
    Limits: 1 to 8 alphanumeric characters

- `--list-requirements` | `--lr` (string)

  - (Optional) Specifies whether to list pre-execution requirements for this job when it enters the request queue.
    Default: Y
    Valid values are:
    Y = The pre-execution requirements will be listedN = The pre-execution requirements will not be listed

- `--prompts` (string)

  - (Optional) Specifies whether to issue prompt messages when this job is late.
    Default: Y
    Valid values are:
    Y = Prompt messages will be issued when the job is lateN = Prompt messages will not be issued when the job is late

- `--requirements-not-used` | `--rnu` (string)

  - (Optional) Specifies whether to issue error messages for job requirements not used.
    Default: Y
    Valid values are:
    Y = Messages will be issued if requirements are not usedN = Messages will not be issued if requirements are not used

- `--dsn-not-found` | `--dnf` (string)

  - (Optional) Specifies whether to list error messages for data sets used at execution time but not found in the CA 7 database.
    Valid when: job-type is CPU
    Default: Y
    Valid values are:
    Y = Messages will be issued if data sets used are not found in the CA 7 databaseN = Messages will not be issued if data sets used are not found in the CA 7 database

- `--job-region` | `--jr` (string)

  - (Optional) Specifies the region size that is required by this job (information only).
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 4 numeric characters

- `--elapsed-time` | `--et` (string)

  - (Optional) CA 7 maintains certain SMF feedback data in its database, including a weighted average elapsed runtime. If the database is updated with a time of 0000, the counters for number of runs, number of times late, and number of restarts are also reset to 0000. One use of this value is deadline prompting. If 2359 is specified, deadline prompt time is not adjusted. It remains due-out time minus lead time.
    Default: 0000
    Limits: 4 numeric characters in HHMM format where HH can be 00 - 23 and MM can be from 00 - 59

- `--average-cpu-time` | `--act` (string)

  - (Optional) CA 7 maintains weighted average CPU time usage values for each job in its database. If the database is updated with a time of 0000, the counters for number of runs, number of times late, and number of restarts are also reset to 0000. One use of this value is deadline prompting. If 2359 is specified, deadline prompt time is not adjusted. It remains due-out time minus lead time.
    Valid when: job-type is CPU
    Default: 0000
    Limits: 4 numeric characters in HHMM format where HH can be 00 - 23 and MM can be from 00 - 59

- `--wlb-job-class` | `--wjc` (string)

  - (Optional) Specifies the CA 7 WLB job class. If not specified, a WLB class of A is automatically assigned. This value does not have to match the JOB statement CLASS value.

    NOTE: The value specified here does not apply when the job enters the queue as a result of a RUN(H) command. Class 9 is assigned by default. To override class 9, use the RUNCLASS keyword on the OPTIONS statement in the initialization file.

    NOTE: The value specified here does not apply when the job enters the queue as a result of a LOAD(H) command. Class 8 is assigned by default. To override class 8, use the LOADCLASS keyword on the OPTIONS statement in the initialization file
    Default: A space
    Limits: 1 alphanumeric character

- `--wlb-priority` | `--wp` (string)

  - (Optional) Specifies the CA 7 WLB job priority. A value of 255 indicates an express priority used to bypass WLB priority scheduling criteria. If using WLB, any job without a specified priority is automatically assigned a priority of 100 unless the default is changed
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0 - 255

- `--message-class` | `--mc` (string)

  - (Optional) Specifies the job's message class. This field is informational only. Even though this field can be changed, it does not cause the JCL to be changed. Also, no validity checking is done on this field.
    Valid when: job-type is CPU
    Default: A space
    Limits: 1 alphanumeric character

- `--drclass` | `--dc` (string)

  - (Optional) Specifies the job's disaster recovery class. This field has no impact on processing during normal execution. When running in disaster recovery mode, the disaster recovery class is used to determine whether the job should execute.
    Limits: 1 to 8 alphanumeric characters. Disaster recovery class values must start with a letter, #, or $ (not @) and can include letters, #, $, @, and numbers. Disaster recovery classes cannot contain embedded blanks

- `--number-1-tape-man` | `--n1tm` (string)

  - (Optional) Specifies a manual override value for the number of TYPE1 tape drives needed for the job. Normally this field is only used to update a job where tape drive requirements have been changed, higher or lower, and the job has not been reloaded after the change. A value of 255 can be used to specify that the job uses 0 TYPE1 tape drives.
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0 - 255

- `--number-2-tape-man` | `--n2tm` (string)

  - (Optional) Specifies a manual override value for the number of TYPE2 tape drives needed for the job. Normally this field is only used to update a job where tape drive requirements have been changed, higher or lower, and the job has not been reloaded after the change. A value of 255 can be used to specify that the job uses 0 TYPE2 tape drives.
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0 - 255

- `--xp-node` | `--xn` (string)

  - (Required when job-type is XPJOB) Defines the CAICCI node to which the execution of this job is targeted. This field should state the primary node. If this node is unavailable and the node definition has alternate nodes defined, the execution of this job can be directed to an alternate node.
    Valid when: job-type is XPJOB
    Limits: 1 to 44 alphanumeric characters, although current z/OS CAICCI restricts this name to eight characters

- `--xp-exec` | `--xe` (string)

  - (Required when job-type is XPJOB) Defines the executable (file, command) to execute at the targeted cross-platform node. If the targeted platform is a mainframe scheduling system such as CA 7, this value indicates the job name to execute on that platform. If the targeted platform is Workload Automation AE system, this value indicates a job that is defined in the Workload Automation AE system. If this field begins and ends in single quote (') marks, these marks are removed before being passed in the transmission data. Otherwise, the field is passed to the target system as-is and in its entirety. This value includes any embedded blanks and quotation marks.
    Valid when: job-type is XPJOB
    Limits: Up to 244 alphanumeric characters, and file delimiters of forward slash (/) and backward slash (\) signs. Note: Each backward slash character must be escaped by specifying (\\)

- `--xp-parm` | `--xp` (string)

  - (Optional) Defines up to 128 bytes of parameter data to pass to the file or command being executed on the alternate platform. This data is supplied as PARM1 to the data being transmitted to the alternate platform. If this field begins and ends in single quote (') marks, these marks are removed before being passed in the transmission data. This value may be overridden if the PARMLIB/MEMBER field PARM1 is coded.
    Valid when: job-type is XPJOB
    Limits: Up to 128 EBCDIC characters

- `--parmlib` | `--pl` (string)

  - (Optional) Defines extra, optional indexed, or symbolic (PDS) library from where execution data to be associated with this job can be found. This information is typically PARM1 through PARM64 keywords but can vary based on CA 7 system configuration options. If the PARM1 field is found within this file, it overrides the data that is specified in the XP PARM field that is listed on the panel.
    Valid when: job-type is XPJOB or AGENT
    Limits: 1 to 16 alphanumeric characters. If this field starts with a numeric value, the value is treated as a JCL Index value (0 - 253 or 256 - 999), and the associated numbered JCL library, as defined in the initialization file JCL statement, is used. If the first character is not numeric, the field must start with an ampersand (&) and must denote the library variable as defined using a /JCL command.
    Note: Specifying data in the PARMLIB/MEMBER fields is in addition to anything specified in the XPPARM field. If XPPARM is coded, and if the PARMLIB/Member contains a PARM1 statement, the PARMLIB specification overrides the XP PARM field. Thus, if both XPPARM and PARMLIB PARM1 fields contain data, the data that is obtained from the PARMLIB/MEMBER is used in the data that is transmitted to the target node

- `--member` (string)

  - (Optional) Indicates the PDS member name in the parmlib library where the parameters for this job reside.
    Valid when: job-type is XPJOB or AGENT
    Default: Same as the job property
    Limits: 1 to 8 alphanumeric characters, beginning with an alphabetic character

- `--sutype` (string)

  - (Optional) Specifies the type of "switch user" command to execute at the UNIX target node.
    Valid when: job-type is XPJOB
    Default: Y
    Valid values are:
    Y = Executes an "SU -" causing the environment setup to include execution of the ".PROFILE" for the target userN = Executes an "SU" command without the profile option

- `--xp-trace` | `--xt` (string)

  - (Optional) Indicates whether to trace the activity that is associated with this job as it moves through the queues.
    Valid when: job-type is XPJOB
    Default: N
    Valid values are:
    Y = Issue WTOs as the job enters into the submission process. Retain up to 256 characters of the data that is sent for inclusion in a log recordN = Do not activate tracing for this job

- `--agent-job-type` | `--ajt` (string)

  - (Required when job-type is AGENT) Defines the type of agent job. For more information about the Agent job types see:
    [CA 7 Documentation](https://techdocs.broadcom.com/us/en/ca-mainframe-software/automation/ca-workload-automation-ca-7-edition/12-1/configuring/interfaces/cross-platform-scheduling/ca-workload-automation-agents/ca-7-agent-job-types.html/)
    Valid when: job-type is AGENT
    Default: There is no default value
    Valid values are:
    UNIX_JOB - Generic UNIXNT_JOB - Microsoft WindowsFILE_TRIGGER - File TriggerFTP_JOB - FTPSCP_JOB - Secure CopySFTP_JOB - Secure File TransferBDC_JOB - SAP Batch Input SessionBWIP_JOB - SAP Business Warehouse InfoPackageBWPC_JOB - SAP Business Warehouse Process ChainSAP_JOB - SAP GenericSAPA_JOB - SAP ArchiveSAPE_JOB - SAP Event MonitorSAPM_JOB - SAP Process MonitorPS_JOB - PeopleSoftOA_JOB - Oracle RequestOAC_JOB - Oracle CopyCPU_MON - CPU MonitorDISK_MON - Disk MonitorIP_MON - IP MonitorPROCESS_MON - Process MonitorTEXT_MON - Text File MonitorEVENTLOG_MON - Event Log MonitorSERVICE_MON - Service MonitorSQL_JOB - Database SQLDBSP_JOB - Database Stored ProcedureDB_MON - Database MonitorDB_TRIG - Database TriggerAS400_JOB - AS400/OS400JMSP_JOB - J2EE JMS PublishJMSS_JOB - J2EE JMS SubscribeEJBE_JOB - J2EE Entity BeanHTTP_JOB - J2EE HTTP/ServletPOJO_JOB - J2EE POJORMI_JOB - J2EE RMIEJB_JOB - J2EE Session BeanJMXB_JOB - JMX-Mbean Attribute GetJMXA_JOB - JMX-Mbean Attribute SetJMXO_JOB - JMX-Mbean OperationJMXS_JOB - JMX-Mbean SubscribeJMXN_JOB - JMX-Mbean Create InstanceJMXR_JOB - JMX-Mbean Remove InstanceSNPG_JOB - SNMP Get AttributeSNPS_JOB - SNMP Set AttributeSNPC_JOB - SNMP SubscribeSNPE_JOB - SNMP TrapSendWEB_SERV - Web ServicesWOL_JOB - Wake-On-LANPROXY_JOB - Remote ExecutionNONSTOP_JOB - HP Integrity NonStop

- `--agent` (string)

  - (Required when job-type is AGENT) Identifies the explicit distributed platform where the job is to run.
    Valid when: job-type is AGENT
    Limits: 1 to 16 alphanumeric characters. The value must be defined to CA 7 using the IASAGENT DD statement

- `--agent-user` | `--au` (string)

  - (Optional) Defines the user ID that is passed to the distributed platform where the job is to run.
    Valid when: job-type is AGENT
    Limits: 1 to 128 alphanumeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- creates a job named JOBA for INSTANCE1:

  - `zowe ca7 job-definition post-job --job JOBA --job-type CPU --ca7Id INSTANCE1 --execute Y --use-jcl-override-library Y --do-not-schedule-before-date 11032 --do-not-schedule-before-time 1100 --do-not-schedule-after-date 11365 --do-not-schedule-after-time 1359`

### zowe › ca7 › job-definition › post-job › 1

Create Job Definition

#### Usage

zowe ca7 job-definition post-job_1 [options]

#### Required Options

- `--job` (string)

  - The name of the job

- `--job-type` | `--jt` (string)

  - The type of job.
    Valid values are:
    CPU = A CPU jobXPJOB = A cross-platform jobAGENT = An Agent job

#### Options

- `--long-name` | `--ln` (string)

  - (Optional) Defines the long job name.
    Limits: 1 to 64 alphanumeric characters, case sensitive

- `--system` (string)

  - (Optional) Specifies the user-defined application system name of which this job is a part.
    Limits: 1 to 8 alphanumeric characters. This field cannot contain a comma

- `--uid` (string)

  - (Optional) Specifies the CA 7 user security identification.
    Default: 0 (no internal security protection)
    Limits: 1 to 3 numeric characters from 0 through 999

- `--jobnet` (string)

  - (Optional) Specifies the name of a CPU job network of which this job is a part.
    Limits: 1 to 8 alphanumeric characters. This field cannot contain a comma

- `--owner` (string)

  - (Optional) Specifies the ID identifying ownership of this job. Depending on the startup options taken, the external security product being used and contents of the JCL, this value can be offered to the external security package by CA 7 at job submission time as the authority for this job to be executed.
    Limits: 1 to 8 alphanumeric characters. Although this field supports up to 8 characters, some external security packages only accept up to 7 characters. This field must not exceed any such limit that exists

- `--jcl-member` | `--jm` (string)

  - (Optional) Specifies the JCL library member name and required when the member name and job name are different.
    Valid when: job-type is CPU
    Default: Job name
    Limits: 1 to 8 alphanumeric characters

- `--id` (string)

  - (Optional) Specifies a numeric index value that is associated with a JCL library where the JCL member is located. NOTE: the id and lib properties are mutually exclusive.
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0-253 or 256-999

- `--lib` (string)

  - (Optional) Specifies a JCL library identification consisting of a symbolic INDEX assigned to a JCL statement. NOTE: the id and lib properties are mutually exclusive.
    Valid when: job-type is CPU
    Limits: 2 to 16 alphanumeric characters beginning with ampersand (&)

- `--reload` (string)

  - (Optional) Specifies whether to reload the JCL of this job. When a job comes into the request queue, it is either flagged for load processing or it is not flagged.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = The job is flagged for load processing. The reload flag is automatically reset to N once the load completes successfullyN = The job is not flagged for load processing unless it is the first time it has run in CA 7X = The job is only flagged for load processing when the LOAD command is used and is never automatically changed even if the LOAD command is used

- `--execute` (string)

  - (Optional) Indicates whether to execute this job.
    Default: Y
    Valid values are:
    Y = The job will be executedN = The job does not run but shows a normal completion as if it did run. JCL is not required for non-executable jobs

- `--retain` (string)

  - (Optional) Specifies whether to retain the execution JCL in the trailer queue after a successful run.
    Valid when: job-type is CPU or XPJOB
    Default: N
    Valid values are:
    Y = Retain the JCL in the trailer queue after a successful run.N = Do not retain the JCL in the trailer queue after a successful run

- `--hold` (string)

  - (Optional) Specifies whether to place this job in a hold status when it enters the request queue.
    Default: N
    Valid values are:
    Y = The job will be heldN = The job will not be held

- `--jcl-override` | `--jo` (string)

  - (Optional) Specifies whether this job needs manual JCL overrides before it can be submitted. Similar to the JCLOVRD command.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = The job needs manual JCL overrides before it can be submittedN = The job does not need manual JCL overrides before it can be submitted

- `--use-jcl-override-library` | `--ujol` (string)

  - (Optional) Specifies whether to retrieve the JCL from the JCL Override library (JCLID=254) for the next run only. This field is automatically set back to N the next time the job comes into the request queue.
    Default: N
    Valid values are:
    Y = The JCL is retrieved from the JCL Override library for the next runN = The JCL is not retrieved from the JCL Override library for the next run

- `--verify` (string)

  - (Optional) Specifies whether this job requires any pre-submission manual verification. Similar to VERIFY command.
    Default: N
    Valid values are:
    Y = The job requires any pre-submission manual verificationN = The job does not require any pre-submission manual verification

- `--maintenance` | `--mai` (string)

  - (Optional) Specifies whether this job is a maintenance job (for example, a system utility) with no production data set requirements. If Y is specified, all input data set requirements are ignored. None of the output data sets created by this job is posted back to CA 7.
    Marking a job as maintenance enables job triggering but not data set triggering.
    Also, if the LOADDSNS keyword is used on the DBASE statement in the initialization file, the LOAD process does not build any DD or data set information for jobs that are marked as maintenance. This means that there are not any data set connections for these jobs unless added manually.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = The job is a maintenance jobN = The job is not a maintenance job

- `--job-requirement-lead-time` | `--jrlt` (string)

  - (Optional) Specifies the number of hours to be considered when satisfying job-dependent requirements.
    Default: 0
    Valid values are:
    0 = No lead time is considered when satisfying this job's requirements99 = Specifies the requirement is never considered as already satisfied when the job enters the queues. Each predecessor job must complete typically while this job is in the request queuenn = Since the last run of this job, specifies that each predecessor job must have run within the last nn hours. Values for nn can be from 1 to 98

- `--dataset-requirement-lead-time` | `--drlt` (string)

  - (Optional) Specifies the number of hours to be considered when satisfying data set requirements.
    Valid when: job-type is CPU
    Default: 0
    Valid values are:
    0 = No lead time is considered when satisfying this job's requirements99 = Specifies the requirement is never considered as already satisfied when the job enters the queues. Each data set requirement must be satisfied typically while this job is in the request queuenn = Since the last run of this job, specifies that each data set requirement must be satisfied within the last nn hours. Values for nn can be from 1 to 98

- `--arfset` (string)

  - (Optional) Names the collection of ARF definitions that apply to this job. Remember that ARF recovery is not invoked for non-executable jobs.
    Limits: 1 to 8 alphanumeric characters

- `--mainid` (string)

  - (Optional) Specifies on which CPU the job can or cannot be scheduled. If the job requirements impose CPU restrictions, specify SYn or /SYn where n is the system number and / indicates not this system. System numbers must be consistent with the initialization file CPU statement MAINIDS parameters.
    Valid when: job-type is CPU
    Default: ALL (lets the job run on any CPU)
    Limits: 1 to 4 alphanumeric characters

- `--insert-ca11-rms` | `--icr` (string)

  - (Optional) Specifies whether to insert the WA Restart_XXX Option RMS step automatically at execution time by CA 7.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = Inserts the step with the WA Restart_XXX Option processing code of PN = Does not insert the RMS step

- `--condition-code` | `--cc` (string)

  - (Optional) Used with relational-operator property to define the job-level condition codes used to determine whether a job executes successfully.
    Valid when: job-type is CPU or XPJOB
    Note: All condition codes that are returned from an XPJOB job are treated as positive values. Any negative value returned is converted to an absolute (positive) value
    Default: 0
    Limits: For job-type = CPU: 1 to 4 numeric characters in the range 0-4095
    For job-type = "XPJOB": 1 to 4 numeric characters in the range 0-9999

- `--relational-operator` | `--ro` (string)

  - (Optional) Specifies the relational operator of the condition-code property or if the step level #SCC statements are being used in the job's JCL.
    Valid when: job-type is CPU or XPJOB
    Default: 0
    Valid values are:
    EQ = Equal toLT = Less thanGT = Greater thanGE = Greater than or equal toLE = Less than or equal toNE = Not equal to#S = Make step condition code tests based on #SCC statements in the JCLIG = Make no evaluation of the job. CA 7 always assumes the job completes successfully, regardless of condition codes, abend codes, or runtime JCL errors. When this is used, the insert-ca11-rms property should be N0 = No condition test will be madeNOTE: If 0 is used, no test is made on the job's condition code. The highest condition code that this job generates is tested by this pair of parameters. For example, if condition-code is set at 8 and RO is set at LT, the job is marked as completing abnormally if 8 is less than the job's highest condition code

- `--do-not-schedule-before-date` | `--dnsbd` (string)

  - (Optional) Specifies not to schedule this job before this date (in YYDDD format, or 00000)

- `--do-not-schedule-before-time` | `--dnsbt` (string)

  - (Optional) Specifies not to schedule this job before this time (in HHMM format)

- `--do-not-schedule-after-date` | `--dnsad` (string)

  - (Optional) Specifies not to schedule this job after this date (in YYDDD format, or 99999)

- `--do-not-schedule-after-time` | `--dnsat` (string)

  - (Optional) Specifies not to schedule this job after this time (in HHMM format)

- `--lterm` (string)

  - (Optional) Routes the messages about this job to this logical terminal name.
    Default: If not entered, the LTERM associated with the JCL library in the initialization file JCL statement is used. If LTERM is not specified on the JCL statement, the default is MASTER
    Limits: 1 to 8 alphanumeric characters

- `--list-requirements` | `--lr` (string)

  - (Optional) Specifies whether to list pre-execution requirements for this job when it enters the request queue.
    Default: Y
    Valid values are:
    Y = The pre-execution requirements will be listedN = The pre-execution requirements will not be listed

- `--prompts` (string)

  - (Optional) Specifies whether to issue prompt messages when this job is late.
    Default: Y
    Valid values are:
    Y = Prompt messages will be issued when the job is lateN = Prompt messages will not be issued when the job is late

- `--requirements-not-used` | `--rnu` (string)

  - (Optional) Specifies whether to issue error messages for job requirements not used.
    Default: Y
    Valid values are:
    Y = Messages will be issued if requirements are not usedN = Messages will not be issued if requirements are not used

- `--dsn-not-found` | `--dnf` (string)

  - (Optional) Specifies whether to list error messages for data sets used at execution time but not found in the CA 7 database.
    Valid when: job-type is CPU
    Default: Y
    Valid values are:
    Y = Messages will be issued if data sets used are not found in the CA 7 databaseN = Messages will not be issued if data sets used are not found in the CA 7 database

- `--job-region` | `--jr` (string)

  - (Optional) Specifies the region size that is required by this job (information only).
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 4 numeric characters

- `--elapsed-time` | `--et` (string)

  - (Optional) CA 7 maintains certain SMF feedback data in its database, including a weighted average elapsed runtime. If the database is updated with a time of 0000, the counters for number of runs, number of times late, and number of restarts are also reset to 0000. One use of this value is deadline prompting. If 2359 is specified, deadline prompt time is not adjusted. It remains due-out time minus lead time.
    Default: 0000
    Limits: 4 numeric characters in HHMM format where HH can be 00 - 23 and MM can be from 00 - 59

- `--average-cpu-time` | `--act` (string)

  - (Optional) CA 7 maintains weighted average CPU time usage values for each job in its database. If the database is updated with a time of 0000, the counters for number of runs, number of times late, and number of restarts are also reset to 0000. One use of this value is deadline prompting. If 2359 is specified, deadline prompt time is not adjusted. It remains due-out time minus lead time.
    Valid when: job-type is CPU
    Default: 0000
    Limits: 4 numeric characters in HHMM format where HH can be 00 - 23 and MM can be from 00 - 59

- `--wlb-job-class` | `--wjc` (string)

  - (Optional) Specifies the CA 7 WLB job class. If not specified, a WLB class of A is automatically assigned. This value does not have to match the JOB statement CLASS value.

    NOTE: The value specified here does not apply when the job enters the queue as a result of a RUN(H) command. Class 9 is assigned by default. To override class 9, use the RUNCLASS keyword on the OPTIONS statement in the initialization file.

    NOTE: The value specified here does not apply when the job enters the queue as a result of a LOAD(H) command. Class 8 is assigned by default. To override class 8, use the LOADCLASS keyword on the OPTIONS statement in the initialization file
    Default: A space
    Limits: 1 alphanumeric character

- `--wlb-priority` | `--wp` (string)

  - (Optional) Specifies the CA 7 WLB job priority. A value of 255 indicates an express priority used to bypass WLB priority scheduling criteria. If using WLB, any job without a specified priority is automatically assigned a priority of 100 unless the default is changed
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0 - 255

- `--message-class` | `--mc` (string)

  - (Optional) Specifies the job's message class. This field is informational only. Even though this field can be changed, it does not cause the JCL to be changed. Also, no validity checking is done on this field.
    Valid when: job-type is CPU
    Default: A space
    Limits: 1 alphanumeric character

- `--drclass` (string)

  - (Optional) Specifies the job's disaster recovery class. This field has no impact on processing during normal execution. When running in disaster recovery mode, the disaster recovery class is used to determine whether the job should execute.
    Limits: 1 to 8 alphanumeric characters. Disaster recovery class values must start with a letter, #, or $ (not @) and can include letters, #, $, @, and numbers. Disaster recovery classes cannot contain embedded blanks

- `--number-1-tape-man` | `--n1tm` (string)

  - (Optional) Specifies a manual override value for the number of TYPE1 tape drives needed for the job. Normally this field is only used to update a job where tape drive requirements have been changed, higher or lower, and the job has not been reloaded after the change. A value of 255 can be used to specify that the job uses 0 TYPE1 tape drives.
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0 - 255

- `--number-2-tape-man` | `--n2tm` (string)

  - (Optional) Specifies a manual override value for the number of TYPE2 tape drives needed for the job. Normally this field is only used to update a job where tape drive requirements have been changed, higher or lower, and the job has not been reloaded after the change. A value of 255 can be used to specify that the job uses 0 TYPE2 tape drives.
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0 - 255

- `--xp-node` | `--xn` (string)

  - (Required when job-type is XPJOB) Defines the CAICCI node to which the execution of this job is targeted. This field should state the primary node. If this node is unavailable and the node definition has alternate nodes defined, the execution of this job can be directed to an alternate node.
    Valid when: job-type is XPJOB
    Limits: 1 to 44 alphanumeric characters, although current z/OS CAICCI restricts this name to eight characters

- `--xp-exec` | `--xe` (string)

  - (Required when job-type is XPJOB) Defines the executable (file, command) to execute at the targeted cross-platform node. If the targeted platform is a mainframe scheduling system such as CA 7, this value indicates the job name to execute on that platform. If the targeted platform is Workload Automation AE system, this value indicates a job that is defined in the Workload Automation AE system. If this field begins and ends in single quote (') marks, these marks are removed before being passed in the transmission data. Otherwise, the field is passed to the target system as-is and in its entirety. This value includes any embedded blanks and quotation marks.
    Valid when: job-type is XPJOB
    Limits: Up to 244 alphanumeric characters, and file delimiters of forward slash (/) and backward slash (\) signs. Note: Each backward slash character must be escaped by specifying (\\)

- `--xp-parm` | `--xp` (string)

  - (Optional) Defines up to 128 bytes of parameter data to pass to the file or command being executed on the alternate platform. This data is supplied as PARM1 to the data being transmitted to the alternate platform. If this field begins and ends in single quote (') marks, these marks are removed before being passed in the transmission data. This value may be overridden if the PARMLIB/MEMBER field PARM1 is coded.
    Valid when: job-type is XPJOB
    Limits: Up to 128 EBCDIC characters

- `--parmlib` (string)

  - (Optional) Defines extra, optional indexed, or symbolic (PDS) library from where execution data to be associated with this job can be found. This information is typically PARM1 through PARM64 keywords but can vary based on CA 7 system configuration options. If the PARM1 field is found within this file, it overrides the data that is specified in the XP PARM field that is listed on the panel.
    Valid when: job-type is XPJOB or AGENT
    Limits: 1 to 16 alphanumeric characters. If this field starts with a numeric value, the value is treated as a JCL Index value (0 - 253 or 256 - 999), and the associated numbered JCL library, as defined in the initialization file JCL statement, is used. If the first character is not numeric, the field must start with an ampersand (&) and must denote the library variable as defined using a /JCL command.
    Note: Specifying data in the PARMLIB/MEMBER fields is in addition to anything specified in the XPPARM field. If XPPARM is coded, and if the PARMLIB/Member contains a PARM1 statement, the PARMLIB specification overrides the XP PARM field. Thus, if both XPPARM and PARMLIB PARM1 fields contain data, the data that is obtained from the PARMLIB/MEMBER is used in the data that is transmitted to the target node

- `--member` (string)

  - (Optional) Indicates the PDS member name in the parmlib library where the parameters for this job reside.
    Valid when: job-type is XPJOB or AGENT
    Default: Same as the job property
    Limits: 1 to 8 alphanumeric characters, beginning with an alphabetic character

- `--sutype` (string)

  - (Optional) Specifies the type of "switch user" command to execute at the UNIX target node.
    Valid when: job-type is XPJOB
    Default: Y
    Valid values are:
    Y = Executes an "SU -" causing the environment setup to include execution of the ".PROFILE" for the target userN = Executes an "SU" command without the profile option

- `--xp-trace` | `--xt` (string)

  - (Optional) Indicates whether to trace the activity that is associated with this job as it moves through the queues.
    Valid when: job-type is XPJOB
    Default: N
    Valid values are:
    Y = Issue WTOs as the job enters into the submission process. Retain up to 256 characters of the data that is sent for inclusion in a log recordN = Do not activate tracing for this job

- `--agent-job-type` | `--ajt` (string)

  - (Required when job-type is AGENT) Defines the type of agent job. For more information about the Agent job types see:
    [CA 7 Documentation](https://techdocs.broadcom.com/us/en/ca-mainframe-software/automation/ca-workload-automation-ca-7-edition/12-1/configuring/interfaces/cross-platform-scheduling/ca-workload-automation-agents/ca-7-agent-job-types.html/)
    Valid when: job-type is AGENT
    Default: There is no default value
    Valid values are:
    UNIX_JOB - Generic UNIXNT_JOB - Microsoft WindowsFILE_TRIGGER - File TriggerFTP_JOB - FTPSCP_JOB - Secure CopySFTP_JOB - Secure File TransferBDC_JOB - SAP Batch Input SessionBWIP_JOB - SAP Business Warehouse InfoPackageBWPC_JOB - SAP Business Warehouse Process ChainSAP_JOB - SAP GenericSAPA_JOB - SAP ArchiveSAPE_JOB - SAP Event MonitorSAPM_JOB - SAP Process MonitorPS_JOB - PeopleSoftOA_JOB - Oracle RequestOAC_JOB - Oracle CopyCPU_MON - CPU MonitorDISK_MON - Disk MonitorIP_MON - IP MonitorPROCESS_MON - Process MonitorTEXT_MON - Text File MonitorEVENTLOG_MON - Event Log MonitorSERVICE_MON - Service MonitorSQL_JOB - Database SQLDBSP_JOB - Database Stored ProcedureDB_MON - Database MonitorDB_TRIG - Database TriggerAS400_JOB - AS400/OS400JMSP_JOB - J2EE JMS PublishJMSS_JOB - J2EE JMS SubscribeEJBE_JOB - J2EE Entity BeanHTTP_JOB - J2EE HTTP/ServletPOJO_JOB - J2EE POJORMI_JOB - J2EE RMIEJB_JOB - J2EE Session BeanJMXB_JOB - JMX-Mbean Attribute GetJMXA_JOB - JMX-Mbean Attribute SetJMXO_JOB - JMX-Mbean OperationJMXS_JOB - JMX-Mbean SubscribeJMXN_JOB - JMX-Mbean Create InstanceJMXR_JOB - JMX-Mbean Remove InstanceSNPG_JOB - SNMP Get AttributeSNPS_JOB - SNMP Set AttributeSNPC_JOB - SNMP SubscribeSNPE_JOB - SNMP TrapSendWEB_SERV - Web ServicesWOL_JOB - Wake-On-LANPROXY_JOB - Remote ExecutionNONSTOP_JOB - HP Integrity NonStop

- `--agent` (string)

  - (Required when job-type is AGENT) Identifies the explicit distributed platform where the job is to run.
    Valid when: job-type is AGENT
    Limits: 1 to 16 alphanumeric characters. The value must be defined to CA 7 using the IASAGENT DD statement

- `--agent-user` | `--au` (string)

  - (Optional) Defines the user ID that is passed to the distributed platform where the job is to run.
    Valid when: job-type is AGENT
    Limits: 1 to 128 alphanumeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- creates a job named JOBA:

  - `zowe ca7 job-definition post-job_1 --job JOBA --job-type CPU --execute Y --use-jcl-override-library Y --do-not-schedule-before-date 11032 --do-not-schedule-before-time 1100 --do-not-schedule-after-date 11365 --do-not-schedule-after-time 1359`

### zowe › ca7 › job-definition › post-job-schedule

Define schedules for jobs that are run on a date and time basis.

#### Usage

zowe ca7 job-definition post-job-schedule [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - The name of the job

- `--schid` (string)

  - Specifies the numeric schedule ID on which the user wants to perform the specified action.
    Limits:
    1 to 3 numeric characters from 1 through 999

#### Options

- `--scal` (string)

  - (Optional) Specifies the override of the default SCAL for this SCHID.
    Specify scal if you want to override the default scal.
    Limits:
    2 alphanumeric characters

- `--default-scal` | `--ds` (string)

  - (Optional) Specifies the default SCAL for this job.
    If this is not specified, an LJOB will be issued to fetch the SCAL
    Limits:
    2 alphanumeric characters

- `--due-out-time` | `--dot` (string)

  - Specifies the due-out time of day for this schedule ID.
    Limits:
    4 numeric characters that are specified as hhmm
    where hh can be 00 through 24
    and mm can be 00 through 59.
    Must be greater than 0000.

- `--lead-time` | `--lt` (string)

  - Specifies the due-out time of day for this schedule ID.
    Limits:
    4 numeric characters that are specified as hhmm
    where hh
    can be 00 through 24 and mm
    can be 00 through 59.
    Must be greater than 0000.

- `--submit-time` | `--st` (string)

  - (Optional) Specifies the submit time of day for this schedule ID.
    If specified, the job is not submitted before this time.
    If the submit time is before deadline start time,
    the submit time requirement is automatically satisfied when the job enters the queue.
    A submit time of zeros is the same as not specifying it, and no submit time is set up.
    Note:If the submit time is after the due-out time, the submit day value is set to the previous day.
    Limits:
    4 numeric characters that are specified as hhmm
    where hh
    can be 00 through 24 and mm
    can be 00 through 59.
    Must be greater than 0000.

- `--daily` (string)

  - (Optional) Specifies that the user wants to define a daily schedule.
    Daily means every available processing day as defined by the Base Calendar.
    If DAILY is used, the ROLL has no effect.
    Limits:One of Y or X

- `--roll` (string)

  - (Optional) Specifies the action to take when a schedule day falls on a base calendar non available processing day.
    This value is not used if the DAILY option is used
    If DAILY is used, the ROLL has no effect.
    If used, the value must be one of the following values: B
    Roll the schedule back to the previous available processing day in the Base Calendar. F
    Roll forward the schedule to the next available processing day. N
    Do not roll. Schedule day must stand. D
    Do not roll and do not schedule.Default:D

- `--index` (string)

  - (Optional) Specifies an adjustment to schedule days.
    After you exercise the ROLL option, the schedule is adjusted,
    forward for plus or backward for minus, by the number of working days entered.
    Limits:4 numeric characters that are specified as Innn
    where I can be plus (unsigned) or minus (-) and nnn can be 0 to 365 daysUsage:
    Use this field with the RDAY field to schedule a job to run three workdays before the 15th of the month:
    specify -3 in the INDEX field, X in the MONTHLY field, and 15 in the RDAY field.

- `--interval` (string)

  - (Optional) Specifies that the job should be repeated (executed more than once) and
    specifies the amount of time between each iteration.
    If INTERVAL is specified, the SBTM (submit time requirement) and TYPE fields are required.
    If both INTERVAL and COUNT are specified, the INTERVAL value times the COUNT value must total less than 24 hours.
    Limits:4 numeric characters in hhmm format where
    hh can be from 0 to 23 and mm can be from 00 to 59

- `--type` (string)

  - (Optional) Determines how the submit time requirement is calculated for repeating jobs.
    A TYPE of CLOCK indicates that the INTERVAL is added to the previous iteration's
    submit time requirement to determine the new submit time requirement.
    A TYPE of START and END indicates that the INTERVAL is added to the previous iteration's
    last (most recent) start and end times,respectively, to determine the new submit time requirement.
    TYPE is required if INTERVAL is specified.
    TYPE is discarded if INTERVAL is not specifiedLimits:CLOCK, START, or END

- `--count` (string)

  - (Optional) Specifies the maximum number of times to repeat the job.
    COUNT is discarded if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating when
    the COUNT reaches zero or the STOP time is reached, whichever comes first.
    If COUNT is not specified, the job repeats until the STOP time is reached.TYPE is required if INTERVAL is specified.
    TYPE is discarded if INTERVAL is not specifiedLimits:1 to 4 numeric characters from 0 to 1439. Leading zeros can be discarded.

- `--stop` (string)

  - (Optional) Specifies the clock time on or after which the job should not be repeated.
    STOP is discarded if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating
    when the COUNT reaches zero or the STOP time is reached, whichever comes first.
    If the STOP time is less than the submit time requirement,
    he stop date is assumed to be the following day.
    A stop time of zeros is the same as not specifying a value.
    Default:1439 minutes (24 hours minus 1 minute) after the submit time.
    Limits:4 numeric characters specified as hhmm,
    where hh can be from 0 to 23 and mm can be from 00 to 59.

- `--weekly` (string)

  - (Optional) Specifies that the user wants to define a weekly schedule.
    If WEEKLY is used, the run days of the week must be specified using DAYS field
    Limits:Y or N

- `--days` (string)

  - (Optional) Defines specific days of the week on which to run the job.
    as comma separated list of day name abbreviations.
    Limits:A comma separated list of Sun,Mon,Tue,Wed,Thu,Fri,Sat

- `--monthly` (string)

  - (Optional) Specifies that the user wants to define a monthly schedule.
    If this field is used, the user can optionally specify on which particular months the job is to run.
    If specific months are not specified in the months property, all months are assumed. Limits:Y or N

- `--months` (string)

  - (Optional) Defines specific months on which to run the job.
    as comma separated list of month name abbreviations.
    Limits:A comma separated list of Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec

- `--weeks-of-month` | `--wom` (string)

  - (Optional)Specifies the weeks of the month to run the job.
    The values that are specified can be positive (unsigned), negative (-) or slash (/).
    Positive values 1, 2, 3, 4, or 5 are used to indicate the week relative to the beginning of the month.
    Negative values -0, -1, and -2 are used to indicate occurrence of week relative to the end of the month.
    Slashes indicate the job will not run the following value.
    Limits:1 to 14 numeric characters and required if MONTHLY and DAY-OF-WEEK are used.
    The values are separated by comma

- `--day-of-week` | `--dow` (string)

  - (Optional)Specifies which days of the week to run the job.
    If used, each day must be the first three letters of the wanted run days.
    If you want to specify multiple days, use a comma separated list for example MON,TUE,FRI.
    Limits: A comma separated list of SUN, MON, TUE, WED, THU, FRI, SAT, case insensitive

- `--relative-day` | `--rd` (string)

  - (Optional)Specifies relative days of the month on which the job is to run.
    Used with MONTHLY.
    A day relative to the beginning or end of the month is specified.
    If a positive (unsigned) value is used, the job runs that day relative to the first of the month.
    Also, if you have days of the month when this job is not to run,a slash (/) can be used with the unsigned or negative values.
    Valid positive values range from 1 to 31.
    Valid negative values range from -0 to -30.
    Limits:1 to 60 numeric characters, separated by comma.
    Note:relative-day(s) represents calendar days,
    unless the base calendar was generated with OPTIONS=SCHDYONLY,
    in which case relative-day(s) represents processing days.

- `--annual` (string)

  - (Optional) Defines an annual schedule.
    Limits: If annual is used, day is required.
    One of Y, N

- `--day-of-year` | `--doy` (string)

  - (Optional) Specifies on which days of the annual schedule the user wants to run the job.
    Days are entered as 1 through 366 and are prefixed by positive (unsigned) or slash (/) values.
    Slash indicates the job will not run this day.
    For example, if a job is to run on days 121, 132, 240, and 241, but is not to run on days 122, 242, and 1, the user would specify:
    /1,121,/122,132,240,241,/242
    Limits:1 to 55 numeric characters and required if annual is used.
    The numbers will be separated by comma

- `--symmetric` (string)

  - (Optional) Used with the START and SPAN fields, defines a symmetric schedule.
    With this option, schedules are defined as beginning on the date specified with
    the START field and recurring every nnn days as specified with the SPAN field.
    Limits:One of Y, N

- `--start` (string)

  - (Optional)This field is required when the SYMETRIC option is taken.
    Value must be specified as the Julian day of the year on which the symmetric schedule is to begin.
    This value should be evaluated yearly before schedule resolution and may need to be changed each year.
    If the schedule will be resolved on a July-June basis, the start date must be within
    the first of the two years in which the schedule overlaps.
    For January-December schedules, it is simply relative to January 1 of the year specified on a RESOLV command.
    If the calendar against which this SCHID will be resolved does not have the OPTIONS=SCHDYONLY,
    the START day is adjusted each year to maintain the job's symmetric schedule from the job's original specified START day.
    If the calendar against which the SCHID will be resolved was generated with overall available processing days only (OPTIONS=SCHDYONLY)
    the start date must specify the first day on which the job would actually run.
    This requires manually setting (verifying) the START value each year before the RESOLV.
    If a nonprocessing day is specified, the start day is the next processing day found in the calendar.
    For example, if January 1 is a nonprocessing day and the calendar was generated with OPTIONS=SCHDYONLY,
    and 1 is specified as the START day, January 2 is the actual START day (provided it is an available processing day).
    SPAN is based from January 2 in this example rather than January 1.
    For other types of calendars, the start date is determined at RESOLV time based on the ROLL and INDEX options taken.
    Limits:3 numeric characters specified as Julian day of the year from 1 to 365

- `--span` (string)

  - (Optional)Used with SYMETRIC and START, defines symmetric schedules.
    This field is required if the SYMETRIC option is taken.
    When used, specifies the number of days between scheduled processing cycles.
    If the calendar against which the SCHID will be resolved was generated with processing days
    only (OPTIONS=SCHDYONLY), the SPAN value is specified as the number of available processing days
    between and including the next processing date as opposed to the actual number of days.
    With this type of calendar, the ROLL and INDEX options serve no practical purpose.
    For other calendar types, the SPAN value is specified as the number of calendar days
    between processing cycles and the ROLL and INDEX options can be used as necessary.
    Limits:1 to 3 numeric characters from 1 to 255

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Create schedule for job TESTJOB1 with the parameters on INSTANCE1:

  - `zowe ca7 job-definition post-job-schedule --job TESTJOB1 --schid 01 --ds 03 --dot 0900 --lt 0900 --st 0900 --daily Y --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › post-job-schedule › 1

Define schedules for jobs that are run on a date and time basis.

#### Usage

zowe ca7 job-definition post-job-schedule_1 [options]

#### Required Options

- `--job` (string)

  - The name of the job

- `--schid` (string)

  - Specifies the numeric schedule ID on which the user wants to perform the specified action.
    Limits:
    1 to 3 numeric characters from 1 through 999

#### Options

- `--scal` (string)

  - (Optional) Specifies the override of the default SCAL for this SCHID.
    Specify scal if you want to override the default scal.
    Limits:
    2 alphanumeric characters

- `--default-scal` | `--ds` (string)

  - (Optional) Specifies the default SCAL for this job.
    If this is not specified, an LJOB will be issued to fetch the SCAL
    Limits:
    2 alphanumeric characters

- `--due-out-time` | `--dot` (string)

  - Specifies the due-out time of day for this schedule ID.
    Limits:
    4 numeric characters that are specified as hhmm
    where hh can be 00 through 24
    and mm can be 00 through 59.
    Must be greater than 0000.

- `--lead-time` | `--lt` (string)

  - Specifies the due-out time of day for this schedule ID.
    Limits:
    4 numeric characters that are specified as hhmm
    where hh
    can be 00 through 24 and mm
    can be 00 through 59.
    Must be greater than 0000.

- `--submit-time` | `--st` (string)

  - (Optional) Specifies the submit time of day for this schedule ID.
    If specified, the job is not submitted before this time.
    If the submit time is before deadline start time,
    the submit time requirement is automatically satisfied when the job enters the queue.
    A submit time of zeros is the same as not specifying it, and no submit time is set up.
    Note:If the submit time is after the due-out time, the submit day value is set to the previous day.
    Limits:
    4 numeric characters that are specified as hhmm
    where hh
    can be 00 through 24 and mm
    can be 00 through 59.
    Must be greater than 0000.

- `--daily` (string)

  - (Optional) Specifies that the user wants to define a daily schedule.
    Daily means every available processing day as defined by the Base Calendar.
    If DAILY is used, the ROLL has no effect.
    Limits:One of Y or X

- `--roll` (string)

  - (Optional) Specifies the action to take when a schedule day falls on a base calendar non available processing day.
    This value is not used if the DAILY option is used
    If DAILY is used, the ROLL has no effect.
    If used, the value must be one of the following values: B
    Roll the schedule back to the previous available processing day in the Base Calendar. F
    Roll forward the schedule to the next available processing day. N
    Do not roll. Schedule day must stand. D
    Do not roll and do not schedule.Default:D

- `--index` (string)

  - (Optional) Specifies an adjustment to schedule days.
    After you exercise the ROLL option, the schedule is adjusted,
    forward for plus or backward for minus, by the number of working days entered.
    Limits:4 numeric characters that are specified as Innn
    where I can be plus (unsigned) or minus (-) and nnn can be 0 to 365 daysUsage:
    Use this field with the RDAY field to schedule a job to run three workdays before the 15th of the month:
    specify -3 in the INDEX field, X in the MONTHLY field, and 15 in the RDAY field.

- `--interval` (string)

  - (Optional) Specifies that the job should be repeated (executed more than once) and
    specifies the amount of time between each iteration.
    If INTERVAL is specified, the SBTM (submit time requirement) and TYPE fields are required.
    If both INTERVAL and COUNT are specified, the INTERVAL value times the COUNT value must total less than 24 hours.
    Limits:4 numeric characters in hhmm format where
    hh can be from 0 to 23 and mm can be from 00 to 59

- `--type` (string)

  - (Optional) Determines how the submit time requirement is calculated for repeating jobs.
    A TYPE of CLOCK indicates that the INTERVAL is added to the previous iteration's
    submit time requirement to determine the new submit time requirement.
    A TYPE of START and END indicates that the INTERVAL is added to the previous iteration's
    last (most recent) start and end times,respectively, to determine the new submit time requirement.
    TYPE is required if INTERVAL is specified.
    TYPE is discarded if INTERVAL is not specifiedLimits:CLOCK, START, or END

- `--count` (string)

  - (Optional) Specifies the maximum number of times to repeat the job.
    COUNT is discarded if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating when
    the COUNT reaches zero or the STOP time is reached, whichever comes first.
    If COUNT is not specified, the job repeats until the STOP time is reached.TYPE is required if INTERVAL is specified.
    TYPE is discarded if INTERVAL is not specifiedLimits:1 to 4 numeric characters from 0 to 1439. Leading zeros can be discarded.

- `--stop` (string)

  - (Optional) Specifies the clock time on or after which the job should not be repeated.
    STOP is discarded if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating
    when the COUNT reaches zero or the STOP time is reached, whichever comes first.
    If the STOP time is less than the submit time requirement,
    he stop date is assumed to be the following day.
    A stop time of zeros is the same as not specifying a value.
    Default:1439 minutes (24 hours minus 1 minute) after the submit time.
    Limits:4 numeric characters specified as hhmm,
    where hh can be from 0 to 23 and mm can be from 00 to 59.

- `--weekly` (string)

  - (Optional) Specifies that the user wants to define a weekly schedule.
    If WEEKLY is used, the run days of the week must be specified using DAYS field
    Limits:Y or N

- `--days` (string)

  - (Optional) Defines specific days of the week on which to run the job.
    as comma separated list of day name abbreviations.
    Limits:A comma separated list of Sun,Mon,Tue,Wed,Thu,Fri,Sat

- `--monthly` (string)

  - (Optional) Specifies that the user wants to define a monthly schedule.
    If this field is used, the user can optionally specify on which particular months the job is to run.
    If specific months are not specified in the months property, all months are assumed. Limits:Y or N

- `--months` (string)

  - (Optional) Defines specific months on which to run the job.
    as comma separated list of month name abbreviations.
    Limits:A comma separated list of Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec

- `--weeks-of-month` | `--wom` (string)

  - (Optional)Specifies the weeks of the month to run the job.
    The values that are specified can be positive (unsigned), negative (-) or slash (/).
    Positive values 1, 2, 3, 4, or 5 are used to indicate the week relative to the beginning of the month.
    Negative values -0, -1, and -2 are used to indicate occurrence of week relative to the end of the month.
    Slashes indicate the job will not run the following value.
    Limits:1 to 14 numeric characters and required if MONTHLY and DAY-OF-WEEK are used.
    The values are separated by comma

- `--day-of-week` | `--dow` (string)

  - (Optional)Specifies which days of the week to run the job.
    If used, each day must be the first three letters of the wanted run days.
    If you want to specify multiple days, use a comma separated list for example MON,TUE,FRI.
    Limits: A comma separated list of SUN, MON, TUE, WED, THU, FRI, SAT, case insensitive

- `--relative-day` | `--rd` (string)

  - (Optional)Specifies relative days of the month on which the job is to run.
    Used with MONTHLY.
    A day relative to the beginning or end of the month is specified.
    If a positive (unsigned) value is used, the job runs that day relative to the first of the month.
    Also, if you have days of the month when this job is not to run,a slash (/) can be used with the unsigned or negative values.
    Valid positive values range from 1 to 31.
    Valid negative values range from -0 to -30.
    Limits:1 to 60 numeric characters, separated by comma.
    Note:relative-day(s) represents calendar days,
    unless the base calendar was generated with OPTIONS=SCHDYONLY,
    in which case relative-day(s) represents processing days.

- `--annual` (string)

  - (Optional) Defines an annual schedule.
    Limits: If annual is used, day is required.
    One of Y, N

- `--day-of-year` | `--doy` (string)

  - (Optional) Specifies on which days of the annual schedule the user wants to run the job.
    Days are entered as 1 through 366 and are prefixed by positive (unsigned) or slash (/) values.
    Slash indicates the job will not run this day.
    For example, if a job is to run on days 121, 132, 240, and 241, but is not to run on days 122, 242, and 1, the user would specify:
    /1,121,/122,132,240,241,/242
    Limits:1 to 55 numeric characters and required if annual is used.
    The numbers will be separated by comma

- `--symmetric` (string)

  - (Optional) Used with the START and SPAN fields, defines a symmetric schedule.
    With this option, schedules are defined as beginning on the date specified with
    the START field and recurring every nnn days as specified with the SPAN field.
    Limits:One of Y, N

- `--start` (string)

  - (Optional)This field is required when the SYMETRIC option is taken.
    Value must be specified as the Julian day of the year on which the symmetric schedule is to begin.
    This value should be evaluated yearly before schedule resolution and may need to be changed each year.
    If the schedule will be resolved on a July-June basis, the start date must be within
    the first of the two years in which the schedule overlaps.
    For January-December schedules, it is simply relative to January 1 of the year specified on a RESOLV command.
    If the calendar against which this SCHID will be resolved does not have the OPTIONS=SCHDYONLY,
    the START day is adjusted each year to maintain the job's symmetric schedule from the job's original specified START day.
    If the calendar against which the SCHID will be resolved was generated with overall available processing days only (OPTIONS=SCHDYONLY)
    the start date must specify the first day on which the job would actually run.
    This requires manually setting (verifying) the START value each year before the RESOLV.
    If a nonprocessing day is specified, the start day is the next processing day found in the calendar.
    For example, if January 1 is a nonprocessing day and the calendar was generated with OPTIONS=SCHDYONLY,
    and 1 is specified as the START day, January 2 is the actual START day (provided it is an available processing day).
    SPAN is based from January 2 in this example rather than January 1.
    For other types of calendars, the start date is determined at RESOLV time based on the ROLL and INDEX options taken.
    Limits:3 numeric characters specified as Julian day of the year from 1 to 365

- `--span` (string)

  - (Optional)Used with SYMETRIC and START, defines symmetric schedules.
    This field is required if the SYMETRIC option is taken.
    When used, specifies the number of days between scheduled processing cycles.
    If the calendar against which the SCHID will be resolved was generated with processing days
    only (OPTIONS=SCHDYONLY), the SPAN value is specified as the number of available processing days
    between and including the next processing date as opposed to the actual number of days.
    With this type of calendar, the ROLL and INDEX options serve no practical purpose.
    For other calendar types, the SPAN value is specified as the number of calendar days
    between processing cycles and the ROLL and INDEX options can be used as necessary.
    Limits:1 to 3 numeric characters from 1 to 255

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Create schedule for job TESTJOB1 with the parameters:

  - `zowe ca7 job-definition post-job-schedule_1 --job TESTJOB1 --schid 01 --ds 03 --dot 0900 --lt 0900 --st 0900 --daily Y`

### zowe › ca7 › job-definition › post-requirement-predecessor

Create requirement definition for a job

#### Usage

zowe ca7 job-definition post-requirement-predecessor [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - The name of the job that requires the predecessor

- `--schid` (string)

  - The schedule id of requiring job

- `--predtype` (string)

  - The predecessor type
    [ JOB, DSN, USER ]

- `--nextrun` (string)

  - The status of predecessor for next run of job
    [ YES, ONLY, SKIP ]

- `--predobject` | `--po` (string)

  - The predecessor. Values vary with predtype.
    When predtype:JOB, predobject is 1-8 character name of required job.
    When predtype:DSN,predobject is 1-44 name of required dataset.
    When predtype:USER then predobject is 1-44 character user requirement text.

#### Options

- `--leadtime` (string)

  - The satisfaction lead time in hours.
    This may be honored when predtype is job or DSN

- `--permanent` (string)

  - Indicates that this predecessor is permanent, that is always considered satisfied.
    This parameter only applies when predtype is DSN.
    [ Y, N ]

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Create requirement definition for a job on INSTANCE1:

  - `zowe ca7 job-definition post-requirement-predecessor --job JOBA --schid 001 --predtype JOBA --nextrun YES --predobject JOBA --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › post-requirement-predecessor › 1

Create requirement definition for a job

#### Usage

zowe ca7 job-definition post-requirement-predecessor_1 [options]

#### Required Options

- `--job` (string)

  - The name of the job that requires the predecessor

- `--schid` (string)

  - The schedule id of requiring job

- `--predtype` (string)

  - The predecessor type
    [ JOB, DSN, USER ]

- `--nextrun` (string)

  - The status of predecessor for next run of job
    [ YES, ONLY, SKIP ]

- `--predobject` | `--po` (string)

  - The predecessor. Values vary with predtype.
    When predtype:JOB, predobject is 1-8 character name of required job.
    When predtype:DSN,predobject is 1-44 name of required dataset.
    When predtype:USER then predobject is 1-44 character user requirement text.

#### Options

- `--leadtime` (string)

  - The satisfaction lead time in hours.
    This may be honored when predtype is job or DSN

- `--permanent` (string)

  - Indicates that this predecessor is permanent, that is always considered satisfied.
    This parameter only applies when predtype is DSN.
    [ Y, N ]

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Create requirement definition for a job:

  - `zowe ca7 job-definition post-requirement-predecessor_1 --job JOBA --schid 001 --predtype JOBA --nextrun YES --predobject JOBA`

### zowe › ca7 › job-definition › post-resource-count-resource

Add a Resource Count resource to the definition of a job

#### Usage

zowe ca7 job-definition post-resource-count-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 39 characters, the first character must be non-blank, and no embedded blanks

- `--resource-count` | `--rc` (string)

  - Specifies the number of occurrences of the resource that the job uses.
    Limits: 1 to 4 numeric characters from 0 through 9999

- `--free` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Valid values are:
    A = Specifies the resource count is only decremented when the job abends
    F = Specifies the resource count is decremented when the job completes, either successfully or unsuccessfully. If the step-name parameter is specified, the resource count is decremented when the specified step completes, either successfully or unsuccessfullyN = Specifies the resource count is not decremented when the job completes. The PRSCF command can be used to decrement the resource count. A cancel of the job also decrements the resource countY = Specifies the resource count is decremented when the job or step ends successfully. If the step-name parameter is specified, the resource count is decremented when the specified step completes successfully (does not abend)

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--step-name` | `--sn` (string)

  - (Optional) Specifies the resource is freed at the conclusion of the named job step.
    Limits: 1 to 8 alphanumeric characters
    Notes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream. This includes any reference to the stepname embedded in a PROCThe only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROCIf a job is restarted in a step after this step-name, the resource does not go through free processing until the job completesA step flush condition does not post the step-name process

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates a job named JOBA with resource name RESOURCE.NAME of free type F, step name JS010 and schedule id 23 for INSTANCE1:

  - `zowe ca7 job-definition post-resource-count-resource --job JOBA --schid 23 --rn RESOURCE.NAME --free F --rc 5 --sn JS010 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › post-resource-count-resource › 1

Add a Resource Count resource to the definition of a job

#### Usage

zowe ca7 job-definition post-resource-count-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 39 characters, the first character must be non-blank, and no embedded blanks

- `--resource-count` | `--rc` (string)

  - Specifies the number of occurrences of the resource that the job uses.
    Limits: 1 to 4 numeric characters from 0 through 9999

- `--free` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Valid values are:
    A = Specifies the resource count is only decremented when the job abends
    F = Specifies the resource count is decremented when the job completes, either successfully or unsuccessfully. If the step-name parameter is specified, the resource count is decremented when the specified step completes, either successfully or unsuccessfullyN = Specifies the resource count is not decremented when the job completes. The PRSCF command can be used to decrement the resource count. A cancel of the job also decrements the resource countY = Specifies the resource count is decremented when the job or step ends successfully. If the step-name parameter is specified, the resource count is decremented when the specified step completes successfully (does not abend)

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--step-name` | `--sn` (string)

  - (Optional) Specifies the resource is freed at the conclusion of the named job step.
    Limits: 1 to 8 alphanumeric characters
    Notes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream. This includes any reference to the stepname embedded in a PROCThe only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROCIf a job is restarted in a step after this step-name, the resource does not go through free processing until the job completesA step flush condition does not post the step-name process

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates a job named JOBA with resource name RESOURCE.NAME of free type F, step name JS010 and schedule id 23:

  - `zowe ca7 job-definition post-resource-count-resource_1 --job JOBA --schid 23 --rn RESOURCE.NAME --free F --sn JS010`

### zowe › ca7 › job-definition › post-shared-resource

Add a Shared resource to the definition of a job

#### Usage

zowe ca7 job-definition post-shared-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

- `--free` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Valid values are:
    A = Specifies the resource is only freed if any step in the job abends (abend or condition code checking)
    F = Specifies the resource is freed when job ends, either successfully or unsuccessfully. If the step-name parameter is specified, free the resource when the specified step completes, either successfully or unsuccessfully
    N = Specifies do not free the resource at successful job completion. The resource can be freed with the PRSCF command. A cancel of the job also frees the resource
    Y = Specifies to free the resource at successful job completion. If the step-name parameter is specified, free the resource when the specified step completes successfully (does not abend)

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--step-name` | `--sn` (string)

  - (Optional) Specifies the resource is freed at the conclusion of the named job step.
    Limits: 1 to 8 alphanumeric characters
    Notes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream. This includes any reference to the stepname embedded in a PROC
    The only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROCIf a job is restarted in a step after this step-name, the resource does not go through free processing until the job completes
    A step flush condition does not post the step-name process

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates a job named JOBAA with resource name SCHENV.VARNAME on INSTANCE1:

  - `zowe ca7 job-definition post-shared-resource --job JOBAA --rn SCHENV.VARNAME --free A --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › post-shared-resource › 1

Add a Shared resource to the definition of a job

#### Usage

zowe ca7 job-definition post-shared-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

- `--free` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Valid values are:
    A = Specifies the resource is only freed if any step in the job abends (abend or condition code checking)
    F = Specifies the resource is freed when job ends, either successfully or unsuccessfully. If the step-name parameter is specified, free the resource when the specified step completes, either successfully or unsuccessfully
    N = Specifies do not free the resource at successful job completion. The resource can be freed with the PRSCF command. A cancel of the job also frees the resource
    Y = Specifies to free the resource at successful job completion. If the step-name parameter is specified, free the resource when the specified step completes successfully (does not abend)

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--step-name` | `--sn` (string)

  - (Optional) Specifies the resource is freed at the conclusion of the named job step.
    Limits: 1 to 8 alphanumeric characters
    Notes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream. This includes any reference to the stepname embedded in a PROC
    The only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROCIf a job is restarted in a step after this step-name, the resource does not go through free processing until the job completes
    A step flush condition does not post the step-name process

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates a job named JOBAA with resource name SCHENV.VARNAME:

  - `zowe ca7 job-definition post-shared-resource_1 --job JOBAA --rn SCHENV.VARNAME --free A`

### zowe › ca7 › job-definition › post-trigger-successor

Add a Job Trigger to the definition of a job

#### Usage

zowe ca7 job-definition post-trigger-successor [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name whose successful completion causes triggering.
    Limits: 1 to 8 alphanumeric characters

- `--triggered-job` | `--tj` (string)

  - Specifies the job name that the completion of the triggering job triggers.
    Limits: 1 to 8 alphanumeric characters

#### Options

- `--schid` (string)

  - (Optional) Specifies for which schedule ID of the triggering job the triggered-job is scheduled.
    Default: 0 (all schedule IDs)
    Limits: 1 to 3 numeric characters from 0 through 999

- `--triggered-job-schid` | `--tjs` (string)

  - (Optional) Denotes a replacement schedule ID to use when the triggered-job is placed into the request queue.
    Default: 0 (no replacement)
    Limits: 1 to 3 numeric characters from 0 through 999
    Note: If triggered-job-schid is used, it replaces the schid value of the triggered job. Any jobs triggered (by triggered-job or data sets it creates) use this triggered-job-schid for their schedule ID unless they also have a triggered-job-schid value.

- `--triggered-job-due-out-time` | `--tjdot` (string)

  - (Required if triggered-job-queue-time is omitted) Specifies the due-out time of day of the triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-queue-time must be omitted.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400. If specified, the lowest value is 10.
    Note: If used and the due-out-time of the triggering job is after the triggered-job-due-out-time, the following calendar day is assumed.

- `--triggered-job-queue-time` | `--tjqt` (string)

  - (Required if triggered-job-due-out-time is omitted) Specifies the elapsed queue time of triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-due-out-time must be omitted because due-out time is then calculated as deadline time plus runtime.
    Deadline time is calculated as current date/time plus queue time.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-lead-time` | `--tjlt` (string)

  - (Optional) Specifies the elapsed lead time for triggered-job rounded to 10-minute increments. This parameter specifies the lead or processing time necessary to ensure triggered-job meets its due-out time.
    Default: 0000
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-submit-time` | `--tjst` (string)

  - (Optional) Imposes a submit time of day requirement on triggered-job. When used, the job is not submitted before this time.
    The triggered-job-submit-time is always rounded down to 15-minute increments.
    Default: 0 (no specific submit time requirement)
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400.Note: If triggered-job-queue-time is used, the date for the submit time requirement is the same as the deadline start date.

    If triggered-job-due-out-time is used and the triggered-job-submit-time is less than the triggered-job-due-out-time, the date for the triggered-job-submit-time is the same as the deadline start date. Otherwise, the triggered-job-submit-time date is the previous day.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Add a Job Trigger to the definition of job JOBA for INSTANCE1:

  - `zowe ca7 job-definition post-trigger-successor --job JOBA --schid 01 --tj JOBA --tjs 02 --tjqt 0910 --tjlt 0910 --tjst 0910 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › post-trigger-successor › 1

Add a Job Trigger to the definition of a job

#### Usage

zowe ca7 job-definition post-trigger-successor_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name whose successful completion causes triggering.
    Limits: 1 to 8 alphanumeric characters

- `--triggered-job` | `--tj` (string)

  - Specifies the job name that the completion of the triggering job triggers.
    Limits: 1 to 8 alphanumeric characters

#### Options

- `--schid` (string)

  - (Optional) Specifies for which schedule ID of the triggering job the triggered-job is scheduled.
    Default: 0 (all schedule IDs)
    Limits: 1 to 3 numeric characters from 0 through 999

- `--triggered-job-schid` | `--tjs` (string)

  - (Optional) Denotes a replacement schedule ID to use when the triggered-job is placed into the request queue.
    Default: 0 (no replacement)
    Limits: 1 to 3 numeric characters from 0 through 999
    Note: If triggered-job-schid is used, it replaces the schid value of the triggered job. Any jobs triggered (by triggered-job or data sets it creates) use this triggered-job-schid for their schedule ID unless they also have a triggered-job-schid value.

- `--triggered-job-due-out-time` | `--tjdot` (string)

  - (Required if triggered-job-queue-time is omitted) Specifies the due-out time of day of the triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-queue-time must be omitted.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400. If specified, the lowest value is 10.
    Note: If used and the due-out-time of the triggering job is after the triggered-job-due-out-time, the following calendar day is assumed.

- `--triggered-job-queue-time` | `--tjqt` (string)

  - (Required if triggered-job-due-out-time is omitted) Specifies the elapsed queue time of triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-due-out-time must be omitted because due-out time is then calculated as deadline time plus runtime.
    Deadline time is calculated as current date/time plus queue time.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-lead-time` | `--tjlt` (string)

  - (Optional) Specifies the elapsed lead time for triggered-job rounded to 10-minute increments. This parameter specifies the lead or processing time necessary to ensure triggered-job meets its due-out time.
    Default: 0000
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-submit-time` | `--tjst` (string)

  - (Optional) Imposes a submit time of day requirement on triggered-job. When used, the job is not submitted before this time.
    The triggered-job-submit-time is always rounded down to 15-minute increments.
    Default: 0 (no specific submit time requirement)
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400.Note: If triggered-job-queue-time is used, the date for the submit time requirement is the same as the deadline start date.

    If triggered-job-due-out-time is used and the triggered-job-submit-time is less than the triggered-job-due-out-time, the date for the triggered-job-submit-time is the same as the deadline start date. Otherwise, the triggered-job-submit-time date is the previous day.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Add a Job Trigger to the definition of job JOBA:

  - `zowe ca7 job-definition post-trigger-successor_1 --job JOBA --schid 01 --tj JOBA --tjs 02 --tjqt 0910 --tjlt 0910 --tjst 0910`

### zowe › ca7 › job-definition › post-variable-resource

Add a Variable resource to the definition of a job

#### Usage

zowe ca7 job-definition post-variable-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: "SCHENV." followed by 1 to 16 alphanumeric and @, #, $, _ characters

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates a job named JOBAA with resource name SCHENV.VARNAME and schedule id 23 for INSTANCE1:

  - `zowe ca7 job-definition post-variable-resource --job JOBAA --schid 23 --rn SCHENV.VARNAME --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › post-variable-resource › 1

Add a Variable resource to the definition of a job

#### Usage

zowe ca7 job-definition post-variable-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: "SCHENV." followed by 1 to 16 alphanumeric and @, #, $, _ characters

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Creates a job named JOBAA with resource name SCHENV.VARNAME and schedule id 23:

  - `zowe ca7 job-definition post-variable-resource_1 --job JOBAA --schid 23 --rn SCHENV.VARNAME`

### zowe › ca7 › job-definition › prose-information

Get a list of the prose information for specified job.

#### Usage

zowe ca7 job-definition prose-information [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- List of the prose information for jobname TESTJOB01 for INSTANCE1:

  - `zowe ca7 job-definition prose-information --jobname TESTJOB --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › prose-information › 1

Get a list of the prose information for specified job.

#### Usage

zowe ca7 job-definition prose-information_1 [options]

#### Required Options

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- List of the prose information for jobname, TESTJOB01:

  - `zowe ca7 job-definition prose-information_1 --jobname TESTJOB`

### zowe › ca7 › job-definition › step-DD

Get a list of the job STEP and DD information for one or more jobs

#### Usage

zowe ca7 job-definition step-DD [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the job STEP and DD information for JOBA for INSTANCE1:

  - `zowe ca7 job-definition step-DD --jobname JOBA --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › step-DD › 1

Get a list of the job STEP and DD information for one or more jobs

#### Usage

zowe ca7 job-definition step-DD_1 [options]

#### Required Options

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the job STEP and DD information for JOBA:

  - `zowe ca7 job-definition step-DD_1 --jobname JOBA`

### zowe › ca7 › job-definition › trigger-predecesssor

Get a list of the trigger objects for one or more jobs

#### Usage

zowe ca7 job-definition trigger-predecesssor [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the trigger objects for JOBA for INSTANCE1:

  - `zowe ca7 job-definition trigger-predecesssor --jobname JOBA --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › trigger-predecesssor › 1

Get a list of the trigger objects for one or more jobs

#### Usage

zowe ca7 job-definition trigger-predecesssor_1 [options]

#### Required Options

- `--jobname` | `--jn` (string)

  - The CA 7 job name

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Get a list of the trigger objects for JOBA:

  - `zowe ca7 job-definition trigger-predecesssor_1 --jobname JOBA`

### zowe › ca7 › job-definition › update-address-space-resource

Modify an Address Space resource for the definition of a job

#### Usage

zowe ca7 job-definition update-address-space-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--ready-when` | `--rw` (string)

  - (Optional) Determines how VRM manages resource availability at job submission and job/step completion.
    Default: A
    Valid values are:
    A = Specifies the job is submitted only if the resource is active on the same system as CA 7. The resource name is assumed to be a jobname or started task name running on the systemI = Specifies the job is submitted only if the resource is not active on the same system as CA 7. The resource name is assumed to be a jobname or started task name running on the system

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates a job named JOBA with resource name RESOURCE.NAME, schedule id 42 and job is submitted only if the resource is not active for INSTANCE1:

  - `zowe ca7 job-definition update-address-space-resource --job JOBA --rn RESOURCE.NAME --rw I--schid 42 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › update-address-space-resource › 1

Modify an Address Space resource for the definition of a job

#### Usage

zowe ca7 job-definition update-address-space-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--ready-when` | `--rw` (string)

  - (Optional) Determines how VRM manages resource availability at job submission and job/step completion.
    Default: A
    Valid values are:
    A = Specifies the job is submitted only if the resource is active on the same system as CA 7. The resource name is assumed to be a jobname or started task name running on the systemI = Specifies the job is submitted only if the resource is not active on the same system as CA 7. The resource name is assumed to be a jobname or started task name running on the system

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates a job named JOBA with resource name RESOURCE.NAME, schedule id 42 and job is submitted only if the resource is not active:

  - `zowe ca7 job-definition update-address-space-resource_1 --job JOBA --rn RESOURCE.NAME --rw I--schid 42`

### zowe › ca7 › job-definition › update-corequisite-resource

Modify Corequisite Resource for the definition of a job

#### Usage

zowe ca7 job-definition update-corequisite-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job-name` | `--jn` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be nonblank, and no embedded blanks
    Exception: If the resource connection is made to a resource count resource,
    the resource name can be from 1 to 39 characters followed by a / (slash) and
    a 1 through 4 numeric value indicating the number of occurrences for the resource that the job uses.

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for
    a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message that is issued.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--ready-when` | `--rw` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Default: A
    Valid values are:
    A
    Specifies the job is submitted only if the resource is active (as established by the PRSQA command).I
    Specifies the job is submitted only if the resource is not active.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates a job named JOBA with resource name RESOURCE.NAME, schedule id 42 and job is submitted only if the resource is not active for INSTANCE1:

  - `zowe ca7 job-definition update-corequisite-resource --jn JOBA --rn RESOURCE.NAME --schid 42 --rw I --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › update-corequisite-resource › 1

Modify Corequisite Resource for the definition of a job

#### Usage

zowe ca7 job-definition update-corequisite-resource_1 [options]

#### Required Options

- `--job-name` | `--jn` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be nonblank, and no embedded blanks
    Exception: If the resource connection is made to a resource count resource,
    the resource name can be from 1 to 39 characters followed by a / (slash) and
    a 1 through 4 numeric value indicating the number of occurrences for the resource that the job uses.

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.
    A zero default cannot be specified for one connection and a nonzero schedule ID used for
    a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message that is issued.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--ready-when` | `--rw` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Default: A
    Valid values are:
    A
    Specifies the job is submitted only if the resource is active (as established by the PRSQA command).I
    Specifies the job is submitted only if the resource is not active.

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates a job named JOBA with resource name RESOURCE.NAME, schedule id 42 and job is submitted only if the resource is not active:

  - `zowe ca7 job-definition update-corequisite-resource_1 --jn JOBA --rn RESOURCE.NAME --schid 42 --rw I`

### zowe › ca7 › job-definition › update-exclusive-resource

Modify an Exclusive resource for the definition of a job

#### Usage

zowe ca7 job-definition update-exclusive-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

- `--free` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Valid values are:
    A = Specifies the resource is only freed if any step in the job abends (abend or condition code checking)
    F = Specifies the resource is freed when job ends, either successfully or unsuccessfully. If the step-name parameter is specified, free the resource when the specified step completes, either successfully or unsuccessfully
    N = Specifies do not free the resource at successful job completion. The resource can be freed with the PRSCF command. A cancel of the job also frees the resource
    Y = Specifies to free the resource at successful job completion. If the step-name parameter is specified, free the resource when the specified step completes successfully (does not abend)

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--step-name` | `--sn` (string)

  - (Optional) Specifies the resource is freed at the conclusion of the named job step.
    Limits: 1 to 8 alphanumeric characters
    Notes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream. This includes any reference to the stepname embedded in a PROCThe only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROCIf a job is restarted in a step after this step-name, the resource does not go through free processing until the job completesA step flush condition does not post the step-name process

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates a job named JOBA with resource name RESOURCE.NAME, of free type F, and schedule id 42 to job with step name JS011 for INSTANCE1:

  - `zowe ca7 job-definition update-exclusive-resource --job JOBA --rn RESOURCE.NAME --free F --sn JS011 --schid 42 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › update-exclusive-resource › 1

Modify an Exclusive resource for the definition of a job

#### Usage

zowe ca7 job-definition update-exclusive-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

- `--free` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Valid values are:
    A = Specifies the resource is only freed if any step in the job abends (abend or condition code checking)
    F = Specifies the resource is freed when job ends, either successfully or unsuccessfully. If the step-name parameter is specified, free the resource when the specified step completes, either successfully or unsuccessfully
    N = Specifies do not free the resource at successful job completion. The resource can be freed with the PRSCF command. A cancel of the job also frees the resource
    Y = Specifies to free the resource at successful job completion. If the step-name parameter is specified, free the resource when the specified step completes successfully (does not abend)

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--step-name` | `--sn` (string)

  - (Optional) Specifies the resource is freed at the conclusion of the named job step.
    Limits: 1 to 8 alphanumeric characters
    Notes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream. This includes any reference to the stepname embedded in a PROCThe only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROCIf a job is restarted in a step after this step-name, the resource does not go through free processing until the job completesA step flush condition does not post the step-name process

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates a job named JOBA with resource name RESOURCE.NAME, of free type F, and schedule id 42 to job with step name JS011:

  - `zowe ca7 job-definition update-exclusive-resource_1 --job JOBA --rn RESOURCE.NAME --free F --sn JS011 --schid 42`

### zowe › ca7 › job-definition › update-job

Update Job Definition

#### Usage

zowe ca7 job-definition update-job [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - The name of the job

- `--job-type` | `--jt` (string)

  - The type of job.
    Valid values are:
    CPU = A CPU jobXPJOB = A cross-platform jobAGENT = An Agent job

#### Options

- `--long-name` | `--ln` (string)

  - (Optional) Defines the long job name.
    Limits: 1 to 64 alphanumeric characters, case sensitive

- `--system` (string)

  - (Optional) Specifies the user-defined application system name of which this job is a part.
    Limits: 1 to 8 alphanumeric characters. This field cannot contain a comma

- `--uid` (string)

  - (Optional) Specifies the CA 7 user security identification.
    Default: 0 (no internal security protection)
    Limits: 1 to 3 numeric characters from 0 through 999

- `--jobnet` (string)

  - (Optional) Specifies the name of a CPU job network of which this job is a part.
    Limits: 1 to 8 alphanumeric characters. This field cannot contain a comma

- `--owner` (string)

  - (Optional) Specifies the ID identifying ownership of this job. Depending on the startup options taken, the external security product being used and contents of the JCL, this value can be offered to the external security package by CA 7 at job submission time as the authority for this job to be executed.
    Limits: 1 to 8 alphanumeric characters. Although this field supports up to 8 characters, some external security packages only accept up to 7 characters. This field must not exceed any such limit that exists

- `--jcl-member` | `--jm` (string)

  - (Optional) Specifies the JCL library member name and required when the member name and job name are different.
    Valid when: job-type is CPU
    Default: Job name
    Limits: 1 to 8 alphanumeric characters

- `--id` (string)

  - (Optional) Specifies a numeric index value that is associated with a JCL library where the JCL member is located. NOTE: the id and lib properties are mutually exclusive.
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0-253 or 256-999

- `--lib` (string)

  - (Optional) Specifies a JCL library identification consisting of a symbolic INDEX assigned to a JCL statement. NOTE: the id and lib properties are mutually exclusive.
    Valid when: job-type is CPU
    Limits: 2 to 16 alphanumeric characters beginning with ampersand (&)

- `--reload` (string)

  - (Optional) Specifies whether to reload the JCL of this job. When a job comes into the request queue, it is either flagged for load processing or it is not flagged.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = The job is flagged for load processing. The reload flag is automatically reset to N once the load completes successfullyN = The job is not flagged for load processing unless it is the first time it has run in CA 7X = The job is only flagged for load processing when the LOAD command is used and is never automatically changed even if the LOAD command is used

- `--execute` (string)

  - (Optional) Indicates whether to execute this job.
    Default: Y
    Valid values are:
    Y = The job will be executedN = The job does not run but shows a normal completion as if it did run. JCL is not required for non-executable jobs

- `--retain` (string)

  - (Optional) Specifies whether to retain the execution JCL in the trailer queue after a successful run.
    Valid when: job-type is CPU or XPJOB
    Default: N
    Valid values are:
    Y = Retain the JCL in the trailer queue after a successful run.N = Do not retain the JCL in the trailer queue after a successful run

- `--hold` (string)

  - (Optional) Specifies whether to place this job in a hold status when it enters the request queue.
    Default: N
    Valid values are:
    Y = The job will be heldN = The job will not be held

- `--jcl-override` | `--jo` (string)

  - (Optional) Specifies whether this job needs manual JCL overrides before it can be submitted. Similar to the JCLOVRD command.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = The job needs manual JCL overrides before it can be submittedN = The job does not need manual JCL overrides before it can be submitted

- `--use-jcl-override-library` | `--ujol` (string)

  - (Optional) Specifies whether to retrieve the JCL from the JCL Override library (JCLID=254) for the next run only. This field is automatically set back to N the next time the job comes into the request queue.
    Default: N
    Valid values are:
    Y = The JCL is retrieved from the JCL Override library for the next runN = The JCL is not retrieved from the JCL Override library for the next run

- `--verify` (string)

  - (Optional) Specifies whether this job requires any pre-submission manual verification. Similar to VERIFY command.
    Default: N
    Valid values are:
    Y = The job requires any pre-submission manual verificationN = The job does not require any pre-submission manual verification

- `--maintenance` | `--maint` (string)

  - (Optional) Specifies whether this job is a maintenance job (for example, a system utility) with no production data set requirements. If Y is specified, all input data set requirements are ignored. None of the output data sets created by this job is posted back to CA 7.
    Marking a job as maintenance enables job triggering but not data set triggering.
    Also, if the LOADDSNS keyword is used on the DBASE statement in the initialization file, the LOAD process does not build any DD or data set information for jobs that are marked as maintenance. This means that there are not any data set connections for these jobs unless added manually.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = The job is a maintenance jobN = The job is not a maintenance job

- `--job-requirement-lead-time` | `--jrlt` (string)

  - (Optional) Specifies the number of hours to be considered when satisfying job-dependent requirements.
    Default: 0
    Valid values are:
    0 = No lead time is considered when satisfying this job's requirements99 = Specifies the requirement is never considered as already satisfied when the job enters the queues. Each predecessor job must complete typically while this job is in the request queuenn = Since the last run of this job, specifies that each predecessor job must have run within the last nn hours. Values for nn can be from 1 to 98

- `--dataset-requirement-lead-time` | `--drlt` (string)

  - (Optional) Specifies the number of hours to be considered when satisfying data set requirements.
    Valid when: job-type is CPU
    Default: 0
    Valid values are:
    0 = No lead time is considered when satisfying this job's requirements99 = Specifies the requirement is never considered as already satisfied when the job enters the queues. Each data set requirement must be satisfied typically while this job is in the request queuenn = Since the last run of this job, specifies that each data set requirement must be satisfied within the last nn hours. Values for nn can be from 1 to 98

- `--arfset` (string)

  - (Optional) Names the collection of ARF definitions that apply to this job. Remember that ARF recovery is not invoked for non-executable jobs.
    Limits: 1 to 8 alphanumeric characters

- `--mainid` (string)

  - (Optional) Specifies on which CPU the job can or cannot be scheduled. If the job requirements impose CPU restrictions, specify SYn or /SYn where n is the system number and / indicates not this system. System numbers must be consistent with the initialization file CPU statement MAINIDS parameters.
    Valid when: job-type is CPU
    Default: ALL (lets the job run on any CPU)
    Limits: 1 to 4 alphanumeric characters

- `--insert-ca11-rms` | `--icr` (string)

  - (Optional) Specifies whether to insert the WA Restart_XXX Option RMS step automatically at execution time by CA 7.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = Inserts the step with the WA Restart_XXX Option processing code of PN = Does not insert the RMS step

- `--condition-code` | `--cc` (string)

  - (Optional) Used with relational-operator property to define the job-level condition codes used to determine whether a job executes successfully.
    Valid when: job-type is CPU or XPJOB
    Note: All condition codes that are returned from an XPJOB job are treated as positive values. Any negative value returned is converted to an absolute (positive) value
    Default: 0
    Limits: For job-type = CPU: 1 to 4 numeric characters in the range 0-4095
    For job-type = "XPJOB": 1 to 4 numeric characters in the range 0-9999

- `--relational-operator` | `--ro` (string)

  - (Optional) Specifies the relational operator of the condition-code property or if the step level #SCC statements are being used in the job's JCL.
    Valid when: job-type is CPU or XPJOB
    Default: 0
    Valid values are:
    EQ = Equal toLT = Less thanGT = Greater thanGE = Greater than or equal toLE = Less than or equal toNE = Not equal to#S = Make step condition code tests based on #SCC statements in the JCLIG = Make no evaluation of the job. CA 7 always assumes the job completes successfully, regardless of condition codes, abend codes, or runtime JCL errors. When this is used, the insert-ca11-rms property should be N0 = No condition test will be madeNOTE: If 0 is used, no test is made on the job's condition code. The highest condition code that this job generates is tested by this pair of parameters. For example, if condition-code is set at 8 and RO is set at LT, the job is marked as completing abnormally if 8 is less than the job's highest condition code

- `--do-not-schedule-before-date` | `--dnsbd` (string)

  - (Optional) Specifies not to schedule this job before this date (in YYDDD format, or 00000)

- `--do-not-schedule-before-time` | `--dnsbt` (string)

  - (Optional) Specifies not to schedule this job before this time (in HHMM format)

- `--do-not-schedule-after-date` | `--dnsad` (string)

  - (Optional) Specifies not to schedule this job after this date (in YYDDD format, or 99999)

- `--do-not-schedule-after-time` | `--dnsat` (string)

  - (Optional) Specifies not to schedule this job after this time (in HHMM format)

- `--lterm` (string)

  - (Optional) Routes the messages about this job to this logical terminal name.
    Default: If not entered, the LTERM associated with the JCL library in the initialization file JCL statement is used. If LTERM is not specified on the JCL statement, the default is MASTER
    Limits: 1 to 8 alphanumeric characters

- `--list-requirements` | `--lr` (string)

  - (Optional) Specifies whether to list pre-execution requirements for this job when it enters the request queue.
    Default: Y
    Valid values are:
    Y = The pre-execution requirements will be listedN = The pre-execution requirements will not be listed

- `--prompts` (string)

  - (Optional) Specifies whether to issue prompt messages when this job is late.
    Default: Y
    Valid values are:
    Y = Prompt messages will be issued when the job is lateN = Prompt messages will not be issued when the job is late

- `--requirements-not-used` | `--rnu` (string)

  - (Optional) Specifies whether to issue error messages for job requirements not used.
    Default: Y
    Valid values are:
    Y = Messages will be issued if requirements are not usedN = Messages will not be issued if requirements are not used

- `--dsn-not-found` | `--dnf` (string)

  - (Optional) Specifies whether to list error messages for data sets used at execution time but not found in the CA 7 database.
    Valid when: job-type is CPU
    Default: Y
    Valid values are:
    Y = Messages will be issued if data sets used are not found in the CA 7 databaseN = Messages will not be issued if data sets used are not found in the CA 7 database

- `--job-region` | `--jr` (string)

  - (Optional) Specifies the region size that is required by this job (information only).
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 4 numeric characters

- `--elapsed-time` | `--et` (string)

  - (Optional) CA 7 maintains certain SMF feedback data in its database, including a weighted average elapsed runtime. If the database is updated with a time of 0000, the counters for number of runs, number of times late, and number of restarts are also reset to 0000. One use of this value is deadline prompting. If 2359 is specified, deadline prompt time is not adjusted. It remains due-out time minus lead time.
    Default: 0000
    Limits: 4 numeric characters in HHMM format where HH can be 00 - 23 and MM can be from 00 - 59

- `--average-cpu-time` | `--act` (string)

  - (Optional) CA 7 maintains weighted average CPU time usage values for each job in its database. If the database is updated with a time of 0000, the counters for number of runs, number of times late, and number of restarts are also reset to 0000. One use of this value is deadline prompting. If 2359 is specified, deadline prompt time is not adjusted. It remains due-out time minus lead time.
    Valid when: job-type is CPU
    Default: 0000
    Limits: 4 numeric characters in HHMM format where HH can be 00 - 23 and MM can be from 00 - 59

- `--wlb-job-class` | `--wjc` (string)

  - (Optional) Specifies the CA 7 WLB job class. If not specified, a WLB class of A is automatically assigned. This value does not have to match the JOB statement CLASS value.

    NOTE: The value specified here does not apply when the job enters the queue as a result of a RUN(H) command. Class 9 is assigned by default. To override class 9, use the RUNCLASS keyword on the OPTIONS statement in the initialization file.

    NOTE: The value specified here does not apply when the job enters the queue as a result of a LOAD(H) command. Class 8 is assigned by default. To override class 8, use the LOADCLASS keyword on the OPTIONS statement in the initialization file
    Default: A space
    Limits: 1 alphanumeric character

- `--wlb-priority` | `--wp` (string)

  - (Optional) Specifies the CA 7 WLB job priority. A value of 255 indicates an express priority used to bypass WLB priority scheduling criteria. If using WLB, any job without a specified priority is automatically assigned a priority of 100 unless the default is changed
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0 - 255

- `--message-class` | `--mc` (string)

  - (Optional) Specifies the job's message class. This field is informational only. Even though this field can be changed, it does not cause the JCL to be changed. Also, no validity checking is done on this field.
    Valid when: job-type is CPU
    Default: A space
    Limits: 1 alphanumeric character

- `--drclass` | `--dc` (string)

  - (Optional) Specifies the job's disaster recovery class. This field has no impact on processing during normal execution. When running in disaster recovery mode, the disaster recovery class is used to determine whether the job should execute.
    Limits: 1 to 8 alphanumeric characters. Disaster recovery class values must start with a letter, #, or $ (not @) and can include letters, #, $, @, and numbers. Disaster recovery classes cannot contain embedded blanks

- `--number-1-tape-man` | `--n1tm` (string)

  - (Optional) Specifies a manual override value for the number of TYPE1 tape drives needed for the job. Normally this field is only used to update a job where tape drive requirements have been changed, higher or lower, and the job has not been reloaded after the change. A value of 255 can be used to specify that the job uses 0 TYPE1 tape drives.
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0 - 255

- `--number-2-tape-man` | `--n2tm` (string)

  - (Optional) Specifies a manual override value for the number of TYPE2 tape drives needed for the job. Normally this field is only used to update a job where tape drive requirements have been changed, higher or lower, and the job has not been reloaded after the change. A value of 255 can be used to specify that the job uses 0 TYPE2 tape drives.
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0 - 255

- `--xp-node` | `--xn` (string)

  - (Required when job-type is XPJOB) Defines the CAICCI node to which the execution of this job is targeted. This field should state the primary node. If this node is unavailable and the node definition has alternate nodes defined, the execution of this job can be directed to an alternate node.
    Valid when: job-type is XPJOB
    Limits: 1 to 44 alphanumeric characters, although current z/OS CAICCI restricts this name to eight characters

- `--xp-exec` | `--xe` (string)

  - (Required when job-type is XPJOB) Defines the executable (file, command) to execute at the targeted cross-platform node. If the targeted platform is a mainframe scheduling system such as CA 7, this value indicates the job name to execute on that platform. If the targeted platform is Workload Automation AE system, this value indicates a job that is defined in the Workload Automation AE system. If this field begins and ends in single quote (') marks, these marks are removed before being passed in the transmission data. Otherwise, the field is passed to the target system as-is and in its entirety. This value includes any embedded blanks and quotation marks.
    Valid when: job-type is XPJOB
    Limits: Up to 244 alphanumeric characters, and file delimiters of forward slash (/) and backward slash (\) signs. Note: Each backward slash character must be escaped by specifying (\\)

- `--xp-parm` | `--xp` (string)

  - (Optional) Defines up to 128 bytes of parameter data to pass to the file or command being executed on the alternate platform. This data is supplied as PARM1 to the data being transmitted to the alternate platform. If this field begins and ends in single quote (') marks, these marks are removed before being passed in the transmission data. This value may be overridden if the PARMLIB/MEMBER field PARM1 is coded.
    Valid when: job-type is XPJOB
    Limits: Up to 128 EBCDIC characters

- `--parmlib` | `--pl` (string)

  - (Optional) Defines extra, optional indexed, or symbolic (PDS) library from where execution data to be associated with this job can be found. This information is typically PARM1 through PARM64 keywords but can vary based on CA 7 system configuration options. If the PARM1 field is found within this file, it overrides the data that is specified in the XP PARM field that is listed on the panel.
    Valid when: job-type is XPJOB or AGENT
    Limits: 1 to 16 alphanumeric characters. If this field starts with a numeric value, the value is treated as a JCL Index value (0 - 253 or 256 - 999), and the associated numbered JCL library, as defined in the initialization file JCL statement, is used. If the first character is not numeric, the field must start with an ampersand (&) and must denote the library variable as defined using a /JCL command.
    Note: Specifying data in the PARMLIB/MEMBER fields is in addition to anything specified in the XPPARM field. If XPPARM is coded, and if the PARMLIB/Member contains a PARM1 statement, the PARMLIB specification overrides the XP PARM field. Thus, if both XPPARM and PARMLIB PARM1 fields contain data, the data that is obtained from the PARMLIB/MEMBER is used in the data that is transmitted to the target node

- `--member` (string)

  - (Optional) Indicates the PDS member name in the parmlib library where the parameters for this job reside.
    Valid when: job-type is XPJOB or AGENT
    Default: Same as the job property
    Limits: 1 to 8 alphanumeric characters, beginning with an alphabetic character

- `--sutype` (string)

  - (Optional) Specifies the type of "switch user" command to execute at the UNIX target node.
    Valid when: job-type is XPJOB
    Default: Y
    Valid values are:
    Y = Executes an "SU -" causing the environment setup to include execution of the ".PROFILE" for the target userN = Executes an "SU" command without the profile option

- `--xp-trace` | `--xt` (string)

  - (Optional) Indicates whether to trace the activity that is associated with this job as it moves through the queues.
    Valid when: job-type is XPJOB
    Default: N
    Valid values are:
    Y = Issue WTOs as the job enters into the submission process. Retain up to 256 characters of the data that is sent for inclusion in a log recordN = Do not activate tracing for this job

- `--agent-job-type` | `--ajt` (string)

  - (Required when job-type is AGENT) Defines the type of agent job. For more information about the Agent job types see:
    [CA 7 Documentation](https://techdocs.broadcom.com/us/en/ca-mainframe-software/automation/ca-workload-automation-ca-7-edition/12-1/configuring/interfaces/cross-platform-scheduling/ca-workload-automation-agents/ca-7-agent-job-types.html/)
    Valid when: job-type is AGENT
    Default: There is no default value
    Valid values are:
    UNIX_JOB - Generic UNIXNT_JOB - Microsoft WindowsFILE_TRIGGER - File TriggerFTP_JOB - FTPSCP_JOB - Secure CopySFTP_JOB - Secure File TransferBDC_JOB - SAP Batch Input SessionBWIP_JOB - SAP Business Warehouse InfoPackageBWPC_JOB - SAP Business Warehouse Process ChainSAP_JOB - SAP GenericSAPA_JOB - SAP ArchiveSAPE_JOB - SAP Event MonitorSAPM_JOB - SAP Process MonitorPS_JOB - PeopleSoftOA_JOB - Oracle RequestOAC_JOB - Oracle CopyCPU_MON - CPU MonitorDISK_MON - Disk MonitorIP_MON - IP MonitorPROCESS_MON - Process MonitorTEXT_MON - Text File MonitorEVENTLOG_MON - Event Log MonitorSERVICE_MON - Service MonitorSQL_JOB - Database SQLDBSP_JOB - Database Stored ProcedureDB_MON - Database MonitorDB_TRIG - Database TriggerAS400_JOB - AS400/OS400JMSP_JOB - J2EE JMS PublishJMSS_JOB - J2EE JMS SubscribeEJBE_JOB - J2EE Entity BeanHTTP_JOB - J2EE HTTP/ServletPOJO_JOB - J2EE POJORMI_JOB - J2EE RMIEJB_JOB - J2EE Session BeanJMXB_JOB - JMX-Mbean Attribute GetJMXA_JOB - JMX-Mbean Attribute SetJMXO_JOB - JMX-Mbean OperationJMXS_JOB - JMX-Mbean SubscribeJMXN_JOB - JMX-Mbean Create InstanceJMXR_JOB - JMX-Mbean Remove InstanceSNPG_JOB - SNMP Get AttributeSNPS_JOB - SNMP Set AttributeSNPC_JOB - SNMP SubscribeSNPE_JOB - SNMP TrapSendWEB_SERV - Web ServicesWOL_JOB - Wake-On-LANPROXY_JOB - Remote ExecutionNONSTOP_JOB - HP Integrity NonStop

- `--agent` (string)

  - (Required when job-type is AGENT) Identifies the explicit distributed platform where the job is to run.
    Valid when: job-type is AGENT
    Limits: 1 to 16 alphanumeric characters. The value must be defined to CA 7 using the IASAGENT DD statement

- `--agent-user` | `--au` (string)

  - (Optional) Defines the user ID that is passed to the distributed platform where the job is to run.
    Valid when: job-type is AGENT
    Limits: 1 to 128 alphanumeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates long name of a job named JOBA to NewJob for INSTANCE1:

  - `zowe ca7 job-definition update-job --job JOBAB --long-name NewJob --job-type CPU --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › update-job › 1

Update Job Definition

#### Usage

zowe ca7 job-definition update-job_1 [options]

#### Required Options

- `--job` (string)

  - The name of the job

- `--job-type` | `--jt` (string)

  - The type of job.
    Valid values are:
    CPU = A CPU jobXPJOB = A cross-platform jobAGENT = An Agent job

#### Options

- `--long-name` | `--ln` (string)

  - (Optional) Defines the long job name.
    Limits: 1 to 64 alphanumeric characters, case sensitive

- `--system` (string)

  - (Optional) Specifies the user-defined application system name of which this job is a part.
    Limits: 1 to 8 alphanumeric characters. This field cannot contain a comma

- `--uid` (string)

  - (Optional) Specifies the CA 7 user security identification.
    Default: 0 (no internal security protection)
    Limits: 1 to 3 numeric characters from 0 through 999

- `--jobnet` (string)

  - (Optional) Specifies the name of a CPU job network of which this job is a part.
    Limits: 1 to 8 alphanumeric characters. This field cannot contain a comma

- `--owner` (string)

  - (Optional) Specifies the ID identifying ownership of this job. Depending on the startup options taken, the external security product being used and contents of the JCL, this value can be offered to the external security package by CA 7 at job submission time as the authority for this job to be executed.
    Limits: 1 to 8 alphanumeric characters. Although this field supports up to 8 characters, some external security packages only accept up to 7 characters. This field must not exceed any such limit that exists

- `--jcl-member` | `--jm` (string)

  - (Optional) Specifies the JCL library member name and required when the member name and job name are different.
    Valid when: job-type is CPU
    Default: Job name
    Limits: 1 to 8 alphanumeric characters

- `--id` (string)

  - (Optional) Specifies a numeric index value that is associated with a JCL library where the JCL member is located. NOTE: the id and lib properties are mutually exclusive.
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0-253 or 256-999

- `--lib` (string)

  - (Optional) Specifies a JCL library identification consisting of a symbolic INDEX assigned to a JCL statement. NOTE: the id and lib properties are mutually exclusive.
    Valid when: job-type is CPU
    Limits: 2 to 16 alphanumeric characters beginning with ampersand (&)

- `--reload` (string)

  - (Optional) Specifies whether to reload the JCL of this job. When a job comes into the request queue, it is either flagged for load processing or it is not flagged.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = The job is flagged for load processing. The reload flag is automatically reset to N once the load completes successfullyN = The job is not flagged for load processing unless it is the first time it has run in CA 7X = The job is only flagged for load processing when the LOAD command is used and is never automatically changed even if the LOAD command is used

- `--execute` (string)

  - (Optional) Indicates whether to execute this job.
    Default: Y
    Valid values are:
    Y = The job will be executedN = The job does not run but shows a normal completion as if it did run. JCL is not required for non-executable jobs

- `--retain` (string)

  - (Optional) Specifies whether to retain the execution JCL in the trailer queue after a successful run.
    Valid when: job-type is CPU or XPJOB
    Default: N
    Valid values are:
    Y = Retain the JCL in the trailer queue after a successful run.N = Do not retain the JCL in the trailer queue after a successful run

- `--hold` (string)

  - (Optional) Specifies whether to place this job in a hold status when it enters the request queue.
    Default: N
    Valid values are:
    Y = The job will be heldN = The job will not be held

- `--jcl-override` | `--jo` (string)

  - (Optional) Specifies whether this job needs manual JCL overrides before it can be submitted. Similar to the JCLOVRD command.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = The job needs manual JCL overrides before it can be submittedN = The job does not need manual JCL overrides before it can be submitted

- `--use-jcl-override-library` | `--ujol` (string)

  - (Optional) Specifies whether to retrieve the JCL from the JCL Override library (JCLID=254) for the next run only. This field is automatically set back to N the next time the job comes into the request queue.
    Default: N
    Valid values are:
    Y = The JCL is retrieved from the JCL Override library for the next runN = The JCL is not retrieved from the JCL Override library for the next run

- `--verify` (string)

  - (Optional) Specifies whether this job requires any pre-submission manual verification. Similar to VERIFY command.
    Default: N
    Valid values are:
    Y = The job requires any pre-submission manual verificationN = The job does not require any pre-submission manual verification

- `--maintenance` | `--mai` (string)

  - (Optional) Specifies whether this job is a maintenance job (for example, a system utility) with no production data set requirements. If Y is specified, all input data set requirements are ignored. None of the output data sets created by this job is posted back to CA 7.
    Marking a job as maintenance enables job triggering but not data set triggering.
    Also, if the LOADDSNS keyword is used on the DBASE statement in the initialization file, the LOAD process does not build any DD or data set information for jobs that are marked as maintenance. This means that there are not any data set connections for these jobs unless added manually.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = The job is a maintenance jobN = The job is not a maintenance job

- `--job-requirement-lead-time` | `--jrlt` (string)

  - (Optional) Specifies the number of hours to be considered when satisfying job-dependent requirements.
    Default: 0
    Valid values are:
    0 = No lead time is considered when satisfying this job's requirements99 = Specifies the requirement is never considered as already satisfied when the job enters the queues. Each predecessor job must complete typically while this job is in the request queuenn = Since the last run of this job, specifies that each predecessor job must have run within the last nn hours. Values for nn can be from 1 to 98

- `--dataset-requirement-lead-time` | `--drlt` (string)

  - (Optional) Specifies the number of hours to be considered when satisfying data set requirements.
    Valid when: job-type is CPU
    Default: 0
    Valid values are:
    0 = No lead time is considered when satisfying this job's requirements99 = Specifies the requirement is never considered as already satisfied when the job enters the queues. Each data set requirement must be satisfied typically while this job is in the request queuenn = Since the last run of this job, specifies that each data set requirement must be satisfied within the last nn hours. Values for nn can be from 1 to 98

- `--arfset` (string)

  - (Optional) Names the collection of ARF definitions that apply to this job. Remember that ARF recovery is not invoked for non-executable jobs.
    Limits: 1 to 8 alphanumeric characters

- `--mainid` (string)

  - (Optional) Specifies on which CPU the job can or cannot be scheduled. If the job requirements impose CPU restrictions, specify SYn or /SYn where n is the system number and / indicates not this system. System numbers must be consistent with the initialization file CPU statement MAINIDS parameters.
    Valid when: job-type is CPU
    Default: ALL (lets the job run on any CPU)
    Limits: 1 to 4 alphanumeric characters

- `--insert-ca11-rms` | `--icr` (string)

  - (Optional) Specifies whether to insert the WA Restart_XXX Option RMS step automatically at execution time by CA 7.
    Valid when: job-type is CPU
    Default: N
    Valid values are:
    Y = Inserts the step with the WA Restart_XXX Option processing code of PN = Does not insert the RMS step

- `--condition-code` | `--cc` (string)

  - (Optional) Used with relational-operator property to define the job-level condition codes used to determine whether a job executes successfully.
    Valid when: job-type is CPU or XPJOB
    Note: All condition codes that are returned from an XPJOB job are treated as positive values. Any negative value returned is converted to an absolute (positive) value
    Default: 0
    Limits: For job-type = CPU: 1 to 4 numeric characters in the range 0-4095
    For job-type = "XPJOB": 1 to 4 numeric characters in the range 0-9999

- `--relational-operator` | `--ro` (string)

  - (Optional) Specifies the relational operator of the condition-code property or if the step level #SCC statements are being used in the job's JCL.
    Valid when: job-type is CPU or XPJOB
    Default: 0
    Valid values are:
    EQ = Equal toLT = Less thanGT = Greater thanGE = Greater than or equal toLE = Less than or equal toNE = Not equal to#S = Make step condition code tests based on #SCC statements in the JCLIG = Make no evaluation of the job. CA 7 always assumes the job completes successfully, regardless of condition codes, abend codes, or runtime JCL errors. When this is used, the insert-ca11-rms property should be N0 = No condition test will be madeNOTE: If 0 is used, no test is made on the job's condition code. The highest condition code that this job generates is tested by this pair of parameters. For example, if condition-code is set at 8 and RO is set at LT, the job is marked as completing abnormally if 8 is less than the job's highest condition code

- `--do-not-schedule-before-date` | `--dnsbd` (string)

  - (Optional) Specifies not to schedule this job before this date (in YYDDD format, or 00000)

- `--do-not-schedule-before-time` | `--dnsbt` (string)

  - (Optional) Specifies not to schedule this job before this time (in HHMM format)

- `--do-not-schedule-after-date` | `--dnsad` (string)

  - (Optional) Specifies not to schedule this job after this date (in YYDDD format, or 99999)

- `--do-not-schedule-after-time` | `--dnsat` (string)

  - (Optional) Specifies not to schedule this job after this time (in HHMM format)

- `--lterm` (string)

  - (Optional) Routes the messages about this job to this logical terminal name.
    Default: If not entered, the LTERM associated with the JCL library in the initialization file JCL statement is used. If LTERM is not specified on the JCL statement, the default is MASTER
    Limits: 1 to 8 alphanumeric characters

- `--list-requirements` | `--lr` (string)

  - (Optional) Specifies whether to list pre-execution requirements for this job when it enters the request queue.
    Default: Y
    Valid values are:
    Y = The pre-execution requirements will be listedN = The pre-execution requirements will not be listed

- `--prompts` (string)

  - (Optional) Specifies whether to issue prompt messages when this job is late.
    Default: Y
    Valid values are:
    Y = Prompt messages will be issued when the job is lateN = Prompt messages will not be issued when the job is late

- `--requirements-not-used` | `--rnu` (string)

  - (Optional) Specifies whether to issue error messages for job requirements not used.
    Default: Y
    Valid values are:
    Y = Messages will be issued if requirements are not usedN = Messages will not be issued if requirements are not used

- `--dsn-not-found` | `--dnf` (string)

  - (Optional) Specifies whether to list error messages for data sets used at execution time but not found in the CA 7 database.
    Valid when: job-type is CPU
    Default: Y
    Valid values are:
    Y = Messages will be issued if data sets used are not found in the CA 7 databaseN = Messages will not be issued if data sets used are not found in the CA 7 database

- `--job-region` | `--jr` (string)

  - (Optional) Specifies the region size that is required by this job (information only).
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 4 numeric characters

- `--elapsed-time` | `--et` (string)

  - (Optional) CA 7 maintains certain SMF feedback data in its database, including a weighted average elapsed runtime. If the database is updated with a time of 0000, the counters for number of runs, number of times late, and number of restarts are also reset to 0000. One use of this value is deadline prompting. If 2359 is specified, deadline prompt time is not adjusted. It remains due-out time minus lead time.
    Default: 0000
    Limits: 4 numeric characters in HHMM format where HH can be 00 - 23 and MM can be from 00 - 59

- `--average-cpu-time` | `--act` (string)

  - (Optional) CA 7 maintains weighted average CPU time usage values for each job in its database. If the database is updated with a time of 0000, the counters for number of runs, number of times late, and number of restarts are also reset to 0000. One use of this value is deadline prompting. If 2359 is specified, deadline prompt time is not adjusted. It remains due-out time minus lead time.
    Valid when: job-type is CPU
    Default: 0000
    Limits: 4 numeric characters in HHMM format where HH can be 00 - 23 and MM can be from 00 - 59

- `--wlb-job-class` | `--wjc` (string)

  - (Optional) Specifies the CA 7 WLB job class. If not specified, a WLB class of A is automatically assigned. This value does not have to match the JOB statement CLASS value.

    NOTE: The value specified here does not apply when the job enters the queue as a result of a RUN(H) command. Class 9 is assigned by default. To override class 9, use the RUNCLASS keyword on the OPTIONS statement in the initialization file.

    NOTE: The value specified here does not apply when the job enters the queue as a result of a LOAD(H) command. Class 8 is assigned by default. To override class 8, use the LOADCLASS keyword on the OPTIONS statement in the initialization file
    Default: A space
    Limits: 1 alphanumeric character

- `--wlb-priority` | `--wp` (string)

  - (Optional) Specifies the CA 7 WLB job priority. A value of 255 indicates an express priority used to bypass WLB priority scheduling criteria. If using WLB, any job without a specified priority is automatically assigned a priority of 100 unless the default is changed
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0 - 255

- `--message-class` | `--mc` (string)

  - (Optional) Specifies the job's message class. This field is informational only. Even though this field can be changed, it does not cause the JCL to be changed. Also, no validity checking is done on this field.
    Valid when: job-type is CPU
    Default: A space
    Limits: 1 alphanumeric character

- `--drclass` (string)

  - (Optional) Specifies the job's disaster recovery class. This field has no impact on processing during normal execution. When running in disaster recovery mode, the disaster recovery class is used to determine whether the job should execute.
    Limits: 1 to 8 alphanumeric characters. Disaster recovery class values must start with a letter, #, or $ (not @) and can include letters, #, $, @, and numbers. Disaster recovery classes cannot contain embedded blanks

- `--number-1-tape-man` | `--n1tm` (string)

  - (Optional) Specifies a manual override value for the number of TYPE1 tape drives needed for the job. Normally this field is only used to update a job where tape drive requirements have been changed, higher or lower, and the job has not been reloaded after the change. A value of 255 can be used to specify that the job uses 0 TYPE1 tape drives.
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0 - 255

- `--number-2-tape-man` | `--n2tm` (string)

  - (Optional) Specifies a manual override value for the number of TYPE2 tape drives needed for the job. Normally this field is only used to update a job where tape drive requirements have been changed, higher or lower, and the job has not been reloaded after the change. A value of 255 can be used to specify that the job uses 0 TYPE2 tape drives.
    Valid when: job-type is CPU
    Default: 0
    Limits: 1 to 3 numeric characters in the range 0 - 255

- `--xp-node` | `--xn` (string)

  - (Required when job-type is XPJOB) Defines the CAICCI node to which the execution of this job is targeted. This field should state the primary node. If this node is unavailable and the node definition has alternate nodes defined, the execution of this job can be directed to an alternate node.
    Valid when: job-type is XPJOB
    Limits: 1 to 44 alphanumeric characters, although current z/OS CAICCI restricts this name to eight characters

- `--xp-exec` | `--xe` (string)

  - (Required when job-type is XPJOB) Defines the executable (file, command) to execute at the targeted cross-platform node. If the targeted platform is a mainframe scheduling system such as CA 7, this value indicates the job name to execute on that platform. If the targeted platform is Workload Automation AE system, this value indicates a job that is defined in the Workload Automation AE system. If this field begins and ends in single quote (') marks, these marks are removed before being passed in the transmission data. Otherwise, the field is passed to the target system as-is and in its entirety. This value includes any embedded blanks and quotation marks.
    Valid when: job-type is XPJOB
    Limits: Up to 244 alphanumeric characters, and file delimiters of forward slash (/) and backward slash (\) signs. Note: Each backward slash character must be escaped by specifying (\\)

- `--xp-parm` | `--xp` (string)

  - (Optional) Defines up to 128 bytes of parameter data to pass to the file or command being executed on the alternate platform. This data is supplied as PARM1 to the data being transmitted to the alternate platform. If this field begins and ends in single quote (') marks, these marks are removed before being passed in the transmission data. This value may be overridden if the PARMLIB/MEMBER field PARM1 is coded.
    Valid when: job-type is XPJOB
    Limits: Up to 128 EBCDIC characters

- `--parmlib` (string)

  - (Optional) Defines extra, optional indexed, or symbolic (PDS) library from where execution data to be associated with this job can be found. This information is typically PARM1 through PARM64 keywords but can vary based on CA 7 system configuration options. If the PARM1 field is found within this file, it overrides the data that is specified in the XP PARM field that is listed on the panel.
    Valid when: job-type is XPJOB or AGENT
    Limits: 1 to 16 alphanumeric characters. If this field starts with a numeric value, the value is treated as a JCL Index value (0 - 253 or 256 - 999), and the associated numbered JCL library, as defined in the initialization file JCL statement, is used. If the first character is not numeric, the field must start with an ampersand (&) and must denote the library variable as defined using a /JCL command.
    Note: Specifying data in the PARMLIB/MEMBER fields is in addition to anything specified in the XPPARM field. If XPPARM is coded, and if the PARMLIB/Member contains a PARM1 statement, the PARMLIB specification overrides the XP PARM field. Thus, if both XPPARM and PARMLIB PARM1 fields contain data, the data that is obtained from the PARMLIB/MEMBER is used in the data that is transmitted to the target node

- `--member` (string)

  - (Optional) Indicates the PDS member name in the parmlib library where the parameters for this job reside.
    Valid when: job-type is XPJOB or AGENT
    Default: Same as the job property
    Limits: 1 to 8 alphanumeric characters, beginning with an alphabetic character

- `--sutype` (string)

  - (Optional) Specifies the type of "switch user" command to execute at the UNIX target node.
    Valid when: job-type is XPJOB
    Default: Y
    Valid values are:
    Y = Executes an "SU -" causing the environment setup to include execution of the ".PROFILE" for the target userN = Executes an "SU" command without the profile option

- `--xp-trace` | `--xt` (string)

  - (Optional) Indicates whether to trace the activity that is associated with this job as it moves through the queues.
    Valid when: job-type is XPJOB
    Default: N
    Valid values are:
    Y = Issue WTOs as the job enters into the submission process. Retain up to 256 characters of the data that is sent for inclusion in a log recordN = Do not activate tracing for this job

- `--agent-job-type` | `--ajt` (string)

  - (Required when job-type is AGENT) Defines the type of agent job. For more information about the Agent job types see:
    [CA 7 Documentation](https://techdocs.broadcom.com/us/en/ca-mainframe-software/automation/ca-workload-automation-ca-7-edition/12-1/configuring/interfaces/cross-platform-scheduling/ca-workload-automation-agents/ca-7-agent-job-types.html/)
    Valid when: job-type is AGENT
    Default: There is no default value
    Valid values are:
    UNIX_JOB - Generic UNIXNT_JOB - Microsoft WindowsFILE_TRIGGER - File TriggerFTP_JOB - FTPSCP_JOB - Secure CopySFTP_JOB - Secure File TransferBDC_JOB - SAP Batch Input SessionBWIP_JOB - SAP Business Warehouse InfoPackageBWPC_JOB - SAP Business Warehouse Process ChainSAP_JOB - SAP GenericSAPA_JOB - SAP ArchiveSAPE_JOB - SAP Event MonitorSAPM_JOB - SAP Process MonitorPS_JOB - PeopleSoftOA_JOB - Oracle RequestOAC_JOB - Oracle CopyCPU_MON - CPU MonitorDISK_MON - Disk MonitorIP_MON - IP MonitorPROCESS_MON - Process MonitorTEXT_MON - Text File MonitorEVENTLOG_MON - Event Log MonitorSERVICE_MON - Service MonitorSQL_JOB - Database SQLDBSP_JOB - Database Stored ProcedureDB_MON - Database MonitorDB_TRIG - Database TriggerAS400_JOB - AS400/OS400JMSP_JOB - J2EE JMS PublishJMSS_JOB - J2EE JMS SubscribeEJBE_JOB - J2EE Entity BeanHTTP_JOB - J2EE HTTP/ServletPOJO_JOB - J2EE POJORMI_JOB - J2EE RMIEJB_JOB - J2EE Session BeanJMXB_JOB - JMX-Mbean Attribute GetJMXA_JOB - JMX-Mbean Attribute SetJMXO_JOB - JMX-Mbean OperationJMXS_JOB - JMX-Mbean SubscribeJMXN_JOB - JMX-Mbean Create InstanceJMXR_JOB - JMX-Mbean Remove InstanceSNPG_JOB - SNMP Get AttributeSNPS_JOB - SNMP Set AttributeSNPC_JOB - SNMP SubscribeSNPE_JOB - SNMP TrapSendWEB_SERV - Web ServicesWOL_JOB - Wake-On-LANPROXY_JOB - Remote ExecutionNONSTOP_JOB - HP Integrity NonStop

- `--agent` (string)

  - (Required when job-type is AGENT) Identifies the explicit distributed platform where the job is to run.
    Valid when: job-type is AGENT
    Limits: 1 to 16 alphanumeric characters. The value must be defined to CA 7 using the IASAGENT DD statement

- `--agent-user` | `--au` (string)

  - (Optional) Defines the user ID that is passed to the distributed platform where the job is to run.
    Valid when: job-type is AGENT
    Limits: 1 to 128 alphanumeric characters

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates long name of a job named JOBA to NewJob:

  - `zowe ca7 job-definition update-job_1 --job JOBAB --long-name NewJob --job-type CPU`

### zowe › ca7 › job-definition › update-job-schedule

Modify schedules for jobs that are run on a date and time basis.

#### Usage

zowe ca7 job-definition update-job-schedule [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - The name of the job

- `--schid` (string)

  - Specifies the numeric schedule ID on which the user wants to perform the specified action.
    Limits:
    1 to 3 numeric characters from 1 through 999

#### Options

- `--scal` (string)

  - (Optional) Specifies the override of the default SCAL for this SCHID.
    Specify scal if you want to override the default scal.
    Limits:
    2 alphanumeric characters

- `--default-scal` | `--ds` (string)

  - (Optional) Specifies the default SCAL for this job.
    If this is not specified, an LJOB will be issued to fetch the SCAL
    Limits:
    2 alphanumeric characters

- `--due-out-time` | `--dot` (string)

  - Specifies the due-out time of day for this schedule ID.
    Limits:
    4 numeric characters that are specified as hhmm
    where hh can be 00 through 24
    and mm can be 00 through 59.
    Must be greater than 0000.

- `--lead-time` | `--lt` (string)

  - Specifies the due-out time of day for this schedule ID.
    Limits:
    4 numeric characters that are specified as hhmm
    where hh
    can be 00 through 24 and mm
    can be 00 through 59.
    Must be greater than 0000.

- `--submit-time` | `--st` (string)

  - (Optional) Specifies the submit time of day for this schedule ID.
    If specified, the job is not submitted before this time.
    If the submit time is before deadline start time,
    the submit time requirement is automatically satisfied when the job enters the queue.
    A submit time of zeros is the same as not specifying it, and no submit time is set up.
    Note:If the submit time is after the due-out time, the submit day value is set to the previous day.
    Limits:
    4 numeric characters that are specified as hhmm
    where hh
    can be 00 through 24 and mm
    can be 00 through 59.
    Must be greater than 0000.

- `--daily` (string)

  - (Optional) Specifies that the user wants to define a daily schedule.
    Daily means every available processing day as defined by the Base Calendar.
    If DAILY is used, the ROLL has no effect.
    Limits:One of Y or X

- `--roll` (string)

  - (Optional) Specifies the action to take when a schedule day falls on a base calendar non available processing day.
    This value is not used if the DAILY option is used
    If DAILY is used, the ROLL has no effect.
    If used, the value must be one of the following values: B
    Roll the schedule back to the previous available processing day in the Base Calendar. F
    Roll forward the schedule to the next available processing day. N
    Do not roll. Schedule day must stand. D
    Do not roll and do not schedule.Default:D

- `--index` (string)

  - (Optional) Specifies an adjustment to schedule days.
    After you exercise the ROLL option, the schedule is adjusted,
    forward for plus or backward for minus, by the number of working days entered.
    Limits:4 numeric characters that are specified as Innn
    where I can be plus (unsigned) or minus (-) and nnn can be 0 to 365 daysUsage:
    Use this field with the RDAY field to schedule a job to run three workdays before the 15th of the month:
    specify -3 in the INDEX field, X in the MONTHLY field, and 15 in the RDAY field.

- `--interval` (string)

  - (Optional) Specifies that the job should be repeated (executed more than once) and
    specifies the amount of time between each iteration.
    If INTERVAL is specified, the SBTM (submit time requirement) and TYPE fields are required.
    If both INTERVAL and COUNT are specified, the INTERVAL value times the COUNT value must total less than 24 hours.
    Limits:4 numeric characters in hhmm format where
    hh can be from 0 to 23 and mm can be from 00 to 59

- `--type` (string)

  - (Optional) Determines how the submit time requirement is calculated for repeating jobs.
    A TYPE of CLOCK indicates that the INTERVAL is added to the previous iteration's
    submit time requirement to determine the new submit time requirement.
    A TYPE of START and END indicates that the INTERVAL is added to the previous iteration's
    last (most recent) start and end times,respectively, to determine the new submit time requirement.
    TYPE is required if INTERVAL is specified.
    TYPE is discarded if INTERVAL is not specifiedLimits:CLOCK, START, or END

- `--count` (string)

  - (Optional) Specifies the maximum number of times to repeat the job.
    COUNT is discarded if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating when
    the COUNT reaches zero or the STOP time is reached, whichever comes first.
    If COUNT is not specified, the job repeats until the STOP time is reached.TYPE is required if INTERVAL is specified.
    TYPE is discarded if INTERVAL is not specifiedLimits:1 to 4 numeric characters from 0 to 1439. Leading zeros can be discarded.

- `--stop` (string)

  - (Optional) Specifies the clock time on or after which the job should not be repeated.
    STOP is discarded if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating
    when the COUNT reaches zero or the STOP time is reached, whichever comes first.
    If the STOP time is less than the submit time requirement,
    he stop date is assumed to be the following day.
    A stop time of zeros is the same as not specifying a value.
    Default:1439 minutes (24 hours minus 1 minute) after the submit time.
    Limits:4 numeric characters specified as hhmm,
    where hh can be from 0 to 23 and mm can be from 00 to 59.

- `--weekly` (string)

  - (Optional) Specifies that the user wants to define a weekly schedule.
    If WEEKLY is used, the run days of the week must be specified using DAYS field
    Limits:Y or N

- `--days` (string)

  - (Optional) Defines specific days of the week on which to run the job.
    as comma separated list of day name abbreviations.
    Limits:A comma separated list of Sun,Mon,Tue,Wed,Thu,Fri,Sat

- `--monthly` (string)

  - (Optional) Specifies that the user wants to define a monthly schedule.
    If this field is used, the user can optionally specify on which particular months the job is to run.
    If specific months are not specified in the months property, all months are assumed. Limits:Y or N

- `--months` (string)

  - (Optional) Defines specific months on which to run the job.
    as comma separated list of month name abbreviations.
    Limits:A comma separated list of Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec

- `--weeks-of-month` | `--wom` (string)

  - (Optional)Specifies the weeks of the month to run the job.
    The values that are specified can be positive (unsigned), negative (-) or slash (/).
    Positive values 1, 2, 3, 4, or 5 are used to indicate the week relative to the beginning of the month.
    Negative values -0, -1, and -2 are used to indicate occurrence of week relative to the end of the month.
    Slashes indicate the job will not run the following value.
    Limits:1 to 14 numeric characters and required if MONTHLY and DAY-OF-WEEK are used.
    The values are separated by comma

- `--day-of-week` | `--dow` (string)

  - (Optional)Specifies which days of the week to run the job.
    If used, each day must be the first three letters of the wanted run days.
    If you want to specify multiple days, use a comma separated list for example MON,TUE,FRI.
    Limits: A comma separated list of SUN, MON, TUE, WED, THU, FRI, SAT, case insensitive

- `--relative-day` | `--rd` (string)

  - (Optional)Specifies relative days of the month on which the job is to run.
    Used with MONTHLY.
    A day relative to the beginning or end of the month is specified.
    If a positive (unsigned) value is used, the job runs that day relative to the first of the month.
    Also, if you have days of the month when this job is not to run,a slash (/) can be used with the unsigned or negative values.
    Valid positive values range from 1 to 31.
    Valid negative values range from -0 to -30.
    Limits:1 to 60 numeric characters, separated by comma.
    Note:relative-day(s) represents calendar days,
    unless the base calendar was generated with OPTIONS=SCHDYONLY,
    in which case relative-day(s) represents processing days.

- `--annual` (string)

  - (Optional) Defines an annual schedule.
    Limits: If annual is used, day is required.
    One of Y, N

- `--day-of-year` | `--doy` (string)

  - (Optional) Specifies on which days of the annual schedule the user wants to run the job.
    Days are entered as 1 through 366 and are prefixed by positive (unsigned) or slash (/) values.
    Slash indicates the job will not run this day.
    For example, if a job is to run on days 121, 132, 240, and 241, but is not to run on days 122, 242, and 1, the user would specify:
    /1,121,/122,132,240,241,/242
    Limits:1 to 55 numeric characters and required if annual is used.
    The numbers will be separated by comma

- `--symmetric` (string)

  - (Optional) Used with the START and SPAN fields, defines a symmetric schedule.
    With this option, schedules are defined as beginning on the date specified with
    the START field and recurring every nnn days as specified with the SPAN field.
    Limits:One of Y, N

- `--start` (string)

  - (Optional)This field is required when the SYMETRIC option is taken.
    Value must be specified as the Julian day of the year on which the symmetric schedule is to begin.
    This value should be evaluated yearly before schedule resolution and may need to be changed each year.
    If the schedule will be resolved on a July-June basis, the start date must be within
    the first of the two years in which the schedule overlaps.
    For January-December schedules, it is simply relative to January 1 of the year specified on a RESOLV command.
    If the calendar against which this SCHID will be resolved does not have the OPTIONS=SCHDYONLY,
    the START day is adjusted each year to maintain the job's symmetric schedule from the job's original specified START day.
    If the calendar against which the SCHID will be resolved was generated with overall available processing days only (OPTIONS=SCHDYONLY)
    the start date must specify the first day on which the job would actually run.
    This requires manually setting (verifying) the START value each year before the RESOLV.
    If a nonprocessing day is specified, the start day is the next processing day found in the calendar.
    For example, if January 1 is a nonprocessing day and the calendar was generated with OPTIONS=SCHDYONLY,
    and 1 is specified as the START day, January 2 is the actual START day (provided it is an available processing day).
    SPAN is based from January 2 in this example rather than January 1.
    For other types of calendars, the start date is determined at RESOLV time based on the ROLL and INDEX options taken.
    Limits:3 numeric characters specified as Julian day of the year from 1 to 365

- `--span` (string)

  - (Optional)Used with SYMETRIC and START, defines symmetric schedules.
    This field is required if the SYMETRIC option is taken.
    When used, specifies the number of days between scheduled processing cycles.
    If the calendar against which the SCHID will be resolved was generated with processing days
    only (OPTIONS=SCHDYONLY), the SPAN value is specified as the number of available processing days
    between and including the next processing date as opposed to the actual number of days.
    With this type of calendar, the ROLL and INDEX options serve no practical purpose.
    For other calendar types, the SPAN value is specified as the number of calendar days
    between processing cycles and the ROLL and INDEX options can be used as necessary.
    Limits:1 to 3 numeric characters from 1 to 255

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Modify a schedule for job TESTJOB1 with the parameters on INSTANCE1:

  - `zowe ca7 job-definition update-job-schedule --job TESTJOB1 --schid 01 --ds 03 --daily Y --dot 0700 --lt 0700 --st 0700 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › update-job-schedule › 1

Modify schedules for jobs that are run on a date and time basis.

#### Usage

zowe ca7 job-definition update-job-schedule_1 [options]

#### Required Options

- `--job` (string)

  - The name of the job

- `--schid` (string)

  - Specifies the numeric schedule ID on which the user wants to perform the specified action.
    Limits:
    1 to 3 numeric characters from 1 through 999

#### Options

- `--scal` (string)

  - (Optional) Specifies the override of the default SCAL for this SCHID.
    Specify scal if you want to override the default scal.
    Limits:
    2 alphanumeric characters

- `--default-scal` | `--ds` (string)

  - (Optional) Specifies the default SCAL for this job.
    If this is not specified, an LJOB will be issued to fetch the SCAL
    Limits:
    2 alphanumeric characters

- `--due-out-time` | `--dot` (string)

  - Specifies the due-out time of day for this schedule ID.
    Limits:
    4 numeric characters that are specified as hhmm
    where hh can be 00 through 24
    and mm can be 00 through 59.
    Must be greater than 0000.

- `--lead-time` | `--lt` (string)

  - Specifies the due-out time of day for this schedule ID.
    Limits:
    4 numeric characters that are specified as hhmm
    where hh
    can be 00 through 24 and mm
    can be 00 through 59.
    Must be greater than 0000.

- `--submit-time` | `--st` (string)

  - (Optional) Specifies the submit time of day for this schedule ID.
    If specified, the job is not submitted before this time.
    If the submit time is before deadline start time,
    the submit time requirement is automatically satisfied when the job enters the queue.
    A submit time of zeros is the same as not specifying it, and no submit time is set up.
    Note:If the submit time is after the due-out time, the submit day value is set to the previous day.
    Limits:
    4 numeric characters that are specified as hhmm
    where hh
    can be 00 through 24 and mm
    can be 00 through 59.
    Must be greater than 0000.

- `--daily` (string)

  - (Optional) Specifies that the user wants to define a daily schedule.
    Daily means every available processing day as defined by the Base Calendar.
    If DAILY is used, the ROLL has no effect.
    Limits:One of Y or X

- `--roll` (string)

  - (Optional) Specifies the action to take when a schedule day falls on a base calendar non available processing day.
    This value is not used if the DAILY option is used
    If DAILY is used, the ROLL has no effect.
    If used, the value must be one of the following values: B
    Roll the schedule back to the previous available processing day in the Base Calendar. F
    Roll forward the schedule to the next available processing day. N
    Do not roll. Schedule day must stand. D
    Do not roll and do not schedule.Default:D

- `--index` (string)

  - (Optional) Specifies an adjustment to schedule days.
    After you exercise the ROLL option, the schedule is adjusted,
    forward for plus or backward for minus, by the number of working days entered.
    Limits:4 numeric characters that are specified as Innn
    where I can be plus (unsigned) or minus (-) and nnn can be 0 to 365 daysUsage:
    Use this field with the RDAY field to schedule a job to run three workdays before the 15th of the month:
    specify -3 in the INDEX field, X in the MONTHLY field, and 15 in the RDAY field.

- `--interval` (string)

  - (Optional) Specifies that the job should be repeated (executed more than once) and
    specifies the amount of time between each iteration.
    If INTERVAL is specified, the SBTM (submit time requirement) and TYPE fields are required.
    If both INTERVAL and COUNT are specified, the INTERVAL value times the COUNT value must total less than 24 hours.
    Limits:4 numeric characters in hhmm format where
    hh can be from 0 to 23 and mm can be from 00 to 59

- `--type` (string)

  - (Optional) Determines how the submit time requirement is calculated for repeating jobs.
    A TYPE of CLOCK indicates that the INTERVAL is added to the previous iteration's
    submit time requirement to determine the new submit time requirement.
    A TYPE of START and END indicates that the INTERVAL is added to the previous iteration's
    last (most recent) start and end times,respectively, to determine the new submit time requirement.
    TYPE is required if INTERVAL is specified.
    TYPE is discarded if INTERVAL is not specifiedLimits:CLOCK, START, or END

- `--count` (string)

  - (Optional) Specifies the maximum number of times to repeat the job.
    COUNT is discarded if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating when
    the COUNT reaches zero or the STOP time is reached, whichever comes first.
    If COUNT is not specified, the job repeats until the STOP time is reached.TYPE is required if INTERVAL is specified.
    TYPE is discarded if INTERVAL is not specifiedLimits:1 to 4 numeric characters from 0 to 1439. Leading zeros can be discarded.

- `--stop` (string)

  - (Optional) Specifies the clock time on or after which the job should not be repeated.
    STOP is discarded if INTERVAL is not specified.
    If both COUNT and STOP are specified, the job stops repeating
    when the COUNT reaches zero or the STOP time is reached, whichever comes first.
    If the STOP time is less than the submit time requirement,
    he stop date is assumed to be the following day.
    A stop time of zeros is the same as not specifying a value.
    Default:1439 minutes (24 hours minus 1 minute) after the submit time.
    Limits:4 numeric characters specified as hhmm,
    where hh can be from 0 to 23 and mm can be from 00 to 59.

- `--weekly` (string)

  - (Optional) Specifies that the user wants to define a weekly schedule.
    If WEEKLY is used, the run days of the week must be specified using DAYS field
    Limits:Y or N

- `--days` (string)

  - (Optional) Defines specific days of the week on which to run the job.
    as comma separated list of day name abbreviations.
    Limits:A comma separated list of Sun,Mon,Tue,Wed,Thu,Fri,Sat

- `--monthly` (string)

  - (Optional) Specifies that the user wants to define a monthly schedule.
    If this field is used, the user can optionally specify on which particular months the job is to run.
    If specific months are not specified in the months property, all months are assumed. Limits:Y or N

- `--months` (string)

  - (Optional) Defines specific months on which to run the job.
    as comma separated list of month name abbreviations.
    Limits:A comma separated list of Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec

- `--weeks-of-month` | `--wom` (string)

  - (Optional)Specifies the weeks of the month to run the job.
    The values that are specified can be positive (unsigned), negative (-) or slash (/).
    Positive values 1, 2, 3, 4, or 5 are used to indicate the week relative to the beginning of the month.
    Negative values -0, -1, and -2 are used to indicate occurrence of week relative to the end of the month.
    Slashes indicate the job will not run the following value.
    Limits:1 to 14 numeric characters and required if MONTHLY and DAY-OF-WEEK are used.
    The values are separated by comma

- `--day-of-week` | `--dow` (string)

  - (Optional)Specifies which days of the week to run the job.
    If used, each day must be the first three letters of the wanted run days.
    If you want to specify multiple days, use a comma separated list for example MON,TUE,FRI.
    Limits: A comma separated list of SUN, MON, TUE, WED, THU, FRI, SAT, case insensitive

- `--relative-day` | `--rd` (string)

  - (Optional)Specifies relative days of the month on which the job is to run.
    Used with MONTHLY.
    A day relative to the beginning or end of the month is specified.
    If a positive (unsigned) value is used, the job runs that day relative to the first of the month.
    Also, if you have days of the month when this job is not to run,a slash (/) can be used with the unsigned or negative values.
    Valid positive values range from 1 to 31.
    Valid negative values range from -0 to -30.
    Limits:1 to 60 numeric characters, separated by comma.
    Note:relative-day(s) represents calendar days,
    unless the base calendar was generated with OPTIONS=SCHDYONLY,
    in which case relative-day(s) represents processing days.

- `--annual` (string)

  - (Optional) Defines an annual schedule.
    Limits: If annual is used, day is required.
    One of Y, N

- `--day-of-year` | `--doy` (string)

  - (Optional) Specifies on which days of the annual schedule the user wants to run the job.
    Days are entered as 1 through 366 and are prefixed by positive (unsigned) or slash (/) values.
    Slash indicates the job will not run this day.
    For example, if a job is to run on days 121, 132, 240, and 241, but is not to run on days 122, 242, and 1, the user would specify:
    /1,121,/122,132,240,241,/242
    Limits:1 to 55 numeric characters and required if annual is used.
    The numbers will be separated by comma

- `--symmetric` (string)

  - (Optional) Used with the START and SPAN fields, defines a symmetric schedule.
    With this option, schedules are defined as beginning on the date specified with
    the START field and recurring every nnn days as specified with the SPAN field.
    Limits:One of Y, N

- `--start` (string)

  - (Optional)This field is required when the SYMETRIC option is taken.
    Value must be specified as the Julian day of the year on which the symmetric schedule is to begin.
    This value should be evaluated yearly before schedule resolution and may need to be changed each year.
    If the schedule will be resolved on a July-June basis, the start date must be within
    the first of the two years in which the schedule overlaps.
    For January-December schedules, it is simply relative to January 1 of the year specified on a RESOLV command.
    If the calendar against which this SCHID will be resolved does not have the OPTIONS=SCHDYONLY,
    the START day is adjusted each year to maintain the job's symmetric schedule from the job's original specified START day.
    If the calendar against which the SCHID will be resolved was generated with overall available processing days only (OPTIONS=SCHDYONLY)
    the start date must specify the first day on which the job would actually run.
    This requires manually setting (verifying) the START value each year before the RESOLV.
    If a nonprocessing day is specified, the start day is the next processing day found in the calendar.
    For example, if January 1 is a nonprocessing day and the calendar was generated with OPTIONS=SCHDYONLY,
    and 1 is specified as the START day, January 2 is the actual START day (provided it is an available processing day).
    SPAN is based from January 2 in this example rather than January 1.
    For other types of calendars, the start date is determined at RESOLV time based on the ROLL and INDEX options taken.
    Limits:3 numeric characters specified as Julian day of the year from 1 to 365

- `--span` (string)

  - (Optional)Used with SYMETRIC and START, defines symmetric schedules.
    This field is required if the SYMETRIC option is taken.
    When used, specifies the number of days between scheduled processing cycles.
    If the calendar against which the SCHID will be resolved was generated with processing days
    only (OPTIONS=SCHDYONLY), the SPAN value is specified as the number of available processing days
    between and including the next processing date as opposed to the actual number of days.
    With this type of calendar, the ROLL and INDEX options serve no practical purpose.
    For other calendar types, the SPAN value is specified as the number of calendar days
    between processing cycles and the ROLL and INDEX options can be used as necessary.
    Limits:1 to 3 numeric characters from 1 to 255

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Modify a schedule for job TESTJOB1 with the parameters:

  - `zowe ca7 job-definition update-job-schedule_1 --job TESTJOB1 --schid 01 --ds 03 --daily Y --dot 0700 --lt 0700 --st 0700`

### zowe › ca7 › job-definition › update-requirement-predecessor

Update requirement definition for a job

#### Usage

zowe ca7 job-definition update-requirement-predecessor [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - The name of the job that requires the predecessor

- `--schid` (string)

  - The schedule id of requiring job

- `--predtype` (string)

  - The predecessor type
    [ JOB, DSN, USER ]

- `--nextrun` (string)

  - The status of predecessor for next run of job
    [ YES, ONLY, SKIP ]

- `--predobject` | `--po` (string)

  - The predecessor. Values vary with predtype.
    When predtype:JOB, predobject is 1-8 character name of required job.
    When predtype:DSN,predobject is 1-44 name of required dataset.
    When predtype:USER then predobject is 1-44 character user requirement text.

#### Options

- `--leadtime` (string)

  - The satisfaction lead time in hours.
    This may be honored when predtype is job or DSN

- `--permanent` (string)

  - Indicates that this predecessor is permanent, that is always considered satisfied.
    This parameter only applies when predtype is DSN.
    [ Y, N ]

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Update requirement definition for a job on INSTANCE1:

  - `zowe ca7 job-definition update-requirement-predecessor --job JOBA --schid 001 --predtype JOBA --nextrun YES --predobject JOBA --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › update-requirement-predecessor › 1

Update requirement definition for a job

#### Usage

zowe ca7 job-definition update-requirement-predecessor_1 [options]

#### Required Options

- `--job` (string)

  - The name of the job that requires the predecessor

- `--schid` (string)

  - The schedule id of requiring job

- `--predtype` (string)

  - The predecessor type

- `--nextrun` (string)

  - The status of predecessor for next run of job
    [ YES, ONLY, SKIP ]

- `--predobject` | `--po` (string)

  - The predecessor. Values vary with predtype.
    When predtype:JOB, predobject is 1-8 character name of required job.
    When predtype:DSN,predobject is 1-44 name of required dataset.
    When predtype:USER then predobject is 1-44 character user requirement text.

#### Options

- `--leadtime` (string)

  - The satisfaction lead time in hours.
    This may be honored when predtype is job or DSN

- `--permanent` (string)

  - Indicates that this predecessor is permanent, that is always considered satisfied.
    This parameter only applies when predtype is DSN.
    [ Y, N ]

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Update requirement definition for a job:

  - `zowe ca7 job-definition update-requirement-predecessor_1 --job JOBA --schid 001 --predtype JOBA --nextrun YES --predobject JOBA`

### zowe › ca7 › job-definition › update-resource-count-resource

Modify a Resource Count resource for the definition of a job

#### Usage

zowe ca7 job-definition update-resource-count-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 39 characters, the first character must be non-blank, and no embedded blanks

- `--free` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Valid values are:
    A = Specifies the resource count is only decremented when the job abends
    F = Specifies the resource count is decremented when the job completes, either successfully or unsuccessfully.
    If the step-name parameter is specified, the resource count is decremented when the specified step completes, either successfully or unsuccessfully
    N = Specifies the resource count is not decremented when the job completes.
    The PRSCF command can be used to decrement the resource count. A cancel of the job also decrements the resource count
    Y = Specifies the resource count is decremented when the job or step ends successfully.
    If the step-name parameter is specified, the resource count is decremented when the specified step completes successfully (does not abend)

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--step-name` | `--sn` (string)

  - (Optional) Specifies the resource is freed at the conclusion of the named job step.
    Limits: 1 to 8 alphanumeric characters
    Notes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream. This includes any reference to the stepname embedded in a PROCThe only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROCIf a job is restarted in a step after this step-name, the resource does not go through free processing until the job completesA step flush condition does not post the step-name process

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates a job named JOBA with resource name RESOURCE.NAME, of free type F, and schedule id 42 to job with step name JS011 for INSTANCE1:

  - `zowe ca7 job-definition update-resource-count-resource --job JOBA --rn RESOURCE.NAME --free F --sn JS011 --schid 42 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › update-resource-count-resource › 1

Modify a Resource Count resource for the definition of a job

#### Usage

zowe ca7 job-definition update-resource-count-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 39 characters, the first character must be non-blank, and no embedded blanks

- `--free` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Valid values are:
    A = Specifies the resource count is only decremented when the job abends
    F = Specifies the resource count is decremented when the job completes, either successfully or unsuccessfully.
    If the step-name parameter is specified, the resource count is decremented when the specified step completes, either successfully or unsuccessfully
    N = Specifies the resource count is not decremented when the job completes.
    The PRSCF command can be used to decrement the resource count. A cancel of the job also decrements the resource count
    Y = Specifies the resource count is decremented when the job or step ends successfully.
    If the step-name parameter is specified, the resource count is decremented when the specified step completes successfully (does not abend)

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--step-name` | `--sn` (string)

  - (Optional) Specifies the resource is freed at the conclusion of the named job step.
    Limits: 1 to 8 alphanumeric characters
    Notes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream. This includes any reference to the stepname embedded in a PROCThe only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROCIf a job is restarted in a step after this step-name, the resource does not go through free processing until the job completesA step flush condition does not post the step-name process

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

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

  - Port for the CA7 API service that is running on the mainframe system.

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

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

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

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

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

  - The name of a (ca7) 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

- `--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

- Updates a job named JOBA with resource name RESOURCE.NAME, of free type F, and schedule id 42 to job with step name JS011:

  - `zowe ca7 job-definition update-resource-count-resource_1 --job JOBA --rn RESOURCE.NAME --free F --sn JS011 --schid 42`

### zowe › ca7 › job-definition › update-shared-resource

Modify a Shared resource for the definition of a job

#### Usage

zowe ca7 job-definition update-shared-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

- `--free` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Valid values are:
    A = Specifies the resource is only freed if any step in the job abends (abend or condition code checking)

    F = Specifies the resource is freed when job ends, either successfully or unsuccessfully.

    If the step-name parameter is specified, free the resource when the specified step completes, either successfully or unsuccessfully

    N = Specifies do not free the resource at successful job completion.

    The resource can be freed with the PRSCF command. A cancel of the job also frees the resource

    Y = Specifies to free the resource at successful job completion.

    If the step-name parameter is specified, free the resource when the specified step completes successfully (does not abend)

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.

    A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--step-name` | `--sn` (string)

  - (Optional) Specifies the resource is freed at the conclusion of the named job step.
    Limits: 1 to 8 alphanumeric characters
    Notes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream.

    This includes any reference to the stepname embedded in a PROC.

    The only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROC

    If a job is restarted in a step after this step-name, the resource does not go through free processing until the job completes

    A step flush condition does not post the step-name process

#### CA7 Connection Options

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

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Updates a job named JOBAA with resource name SCHENV.VARNAME on INSTANCE1:

  - `zowe ca7 job-definition update-shared-resource --job JOBAA --rn SCHENV.VARNAME --free A --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › update-shared-resource › 1

Modify a Shared resource for the definition of a job

#### Usage

zowe ca7 job-definition update-shared-resource_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name on which the indicated function is performed.
    Limits: 1 to 8 alphanumeric characters

- `--resource-name` | `--rn` (string)

  - Specifies the resource name being connected to the job.
    Limits: 1 to 44 characters, the first character must be non-blank, and no embedded blanks

- `--free` (string)

  - Determines how VRM manages resource availability at job submission and job/step completion.
    Valid values are:
    A = Specifies the resource is only freed if any step in the job abends (abend or condition code checking)

    F = Specifies the resource is freed when job ends, either successfully or unsuccessfully.

    If the step-name parameter is specified, free the resource when the specified step completes, either successfully or unsuccessfully

    N = Specifies do not free the resource at successful job completion.

    The resource can be freed with the PRSCF command. A cancel of the job also frees the resource

    Y = Specifies to free the resource at successful job completion.

    If the step-name parameter is specified, free the resource when the specified step completes successfully (does not abend)

#### Options

- `--schid` (string)

  - (Optional) Specifies the schedule ID (of this job) for which a user requirement is applied.

    A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description.
    An attempt to make such a connection results in an error message.
    Default: 0, which indicates that the requirement holds for all schedule IDs
    Limits: 1 to 3 numeric characters from 0 through 999

- `--step-name` | `--sn` (string)

  - (Optional) Specifies the resource is freed at the conclusion of the named job step.
    Limits: 1 to 8 alphanumeric characters
    Notes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream.

    This includes any reference to the stepname embedded in a PROC.

    The only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROC

    If a job is restarted in a step after this step-name, the resource does not go through free processing until the job completes

    A step flush condition does not post the step-name process

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Updates a job named JOBAA with resource name SCHENV.VARNAME:

  - `zowe ca7 job-definition update-shared-resource_1 --job JOBAA --rn SCHENV.VARNAME --free A`

### zowe › ca7 › job-definition › update-trigger-successor

Modify a Job Trigger for the definition of a job

#### Usage

zowe ca7 job-definition update-trigger-successor [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--job` (string)

  - Specifies the job name whose successful completion causes triggering.
    Limits: 1 to 8 alphanumeric characters

- `--triggered-job` | `--tj` (string)

  - Specifies the job name that the completion of the triggering job triggers.
    Limits: 1 to 8 alphanumeric characters

#### Options

- `--schid` (string)

  - (Optional) Specifies for which schedule ID of the triggering job the triggered-job is scheduled.
    Default: 0 (all schedule IDs)
    Limits: 1 to 3 numeric characters from 0 through 999

- `--triggered-job-schid` | `--tjs` (string)

  - (Optional) Denotes a replacement schedule ID to use when the triggered-job is placed into the request queue.
    Default: 0 (no replacement)
    Limits: 1 to 3 numeric characters from 0 through 999
    Note: If triggered-job-schid is used, it replaces the schid value of the triggered job. Any jobs triggered (by triggered-job or data sets it creates) use this triggered-job-schid for their schedule ID unless they also have a triggered-job-schid value.

- `--triggered-job-due-out-time` | `--tjdot` (string)

  - (Required if triggered-job-queue-time is omitted) Specifies the due-out time of day of the triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-queue-time must be omitted.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400. If specified, the lowest value is 10.
    Note: If used and the due-out-time of the triggering job is after the triggered-job-due-out-time, the following calendar day is assumed.

- `--triggered-job-queue-time` | `--tjqt` (string)

  - (Required if triggered-job-due-out-time is omitted) Specifies the elapsed queue time of triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-due-out-time must be omitted because due-out time is then calculated as deadline time plus runtime.
    Deadline time is calculated as current date/time plus queue time.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-lead-time` | `--tjlt` (string)

  - (Optional) Specifies the elapsed lead time for triggered-job rounded to 10-minute increments. This parameter specifies the lead or processing time necessary to ensure triggered-job meets its due-out time.
    Default: 0000
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-submit-time` | `--tjst` (string)

  - (Optional) Imposes a submit time of day requirement on triggered-job. When used, the job is not submitted before this time.
    The triggered-job-submit-time is always rounded down to 15-minute increments.
    Default: 0 (no specific submit time requirement)
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400.Note: If triggered-job-queue-time is used, the date for the submit time requirement is the same as the deadline start date.

    If triggered-job-due-out-time is used and the triggered-job-submit-time is less than the triggered-job-due-out-time, the date for the triggered-job-submit-time is the same as the deadline start date. Otherwise, the triggered-job-submit-time date is the previous day.

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Update Job Trigger to the definition of job JOBA for INSTANCE1:

  - `zowe ca7 job-definition update-trigger-successor --job JOBA --schid 01 --tj JOBA --tjs 02 --tjqt 0910 --tjlt 0910 --tjst 0910 --ca7Id INSTANCE1`

### zowe › ca7 › job-definition › update-trigger-successor › 1

Modify a Job Trigger for the definition of a job

#### Usage

zowe ca7 job-definition update-trigger-successor_1 [options]

#### Required Options

- `--job` (string)

  - Specifies the job name whose successful completion causes triggering.
    Limits: 1 to 8 alphanumeric characters

- `--triggered-job` | `--tj` (string)

  - Specifies the job name that the completion of the triggering job triggers.
    Limits: 1 to 8 alphanumeric characters

#### Options

- `--schid` (string)

  - (Optional) Specifies for which schedule ID of the triggering job the triggered-job is scheduled.
    Default: 0 (all schedule IDs)
    Limits: 1 to 3 numeric characters from 0 through 999

- `--triggered-job-schid` | `--tjs` (string)

  - (Optional) Denotes a replacement schedule ID to use when the triggered-job is placed into the request queue.
    Default: 0 (no replacement)
    Limits: 1 to 3 numeric characters from 0 through 999
    Note: If triggered-job-schid is used, it replaces the schid value of the triggered job. Any jobs triggered (by triggered-job or data sets it creates) use this triggered-job-schid for their schedule ID unless they also have a triggered-job-schid value.

- `--triggered-job-due-out-time` | `--tjdot` (string)

  - (Required if triggered-job-queue-time is omitted) Specifies the due-out time of day of the triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-queue-time must be omitted.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400. If specified, the lowest value is 10.
    Note: If used and the due-out-time of the triggering job is after the triggered-job-due-out-time, the following calendar day is assumed.

- `--triggered-job-queue-time` | `--tjqt` (string)

  - (Required if triggered-job-due-out-time is omitted) Specifies the elapsed queue time of triggered-job rounded down to 10-minute increments.
    If this parameter is used, triggered-job-due-out-time must be omitted because due-out time is then calculated as deadline time plus runtime.
    Deadline time is calculated as current date/time plus queue time.
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-lead-time` | `--tjlt` (string)

  - (Optional) Specifies the elapsed lead time for triggered-job rounded to 10-minute increments. This parameter specifies the lead or processing time necessary to ensure triggered-job meets its due-out time.
    Default: 0000
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24.
    The mm can be 00 through 59, the highest value being 2400.

- `--triggered-job-submit-time` | `--tjst` (string)

  - (Optional) Imposes a submit time of day requirement on triggered-job. When used, the job is not submitted before this time.
    The triggered-job-submit-time is always rounded down to 15-minute increments.
    Default: 0 (no specific submit time requirement)
    Limits: 4 numeric characters that are specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400.Note: If triggered-job-queue-time is used, the date for the submit time requirement is the same as the deadline start date.

    If triggered-job-due-out-time is used and the triggered-job-submit-time is less than the triggered-job-due-out-time, the date for the triggered-job-submit-time is the same as the deadline start date. Otherwise, the triggered-job-submit-time date is the previous day.

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Update Job Trigger to the definition of job JOBA:

  - `zowe ca7 job-definition update-trigger-successor_1 --job JOBA --schid 01 --tj JOBA --tjs 02 --tjqt 0910 --tjlt 0910 --tjst 0910`

## zowe › ca7 › job-history

CA 7 historical job information

### zowe › ca7 › job-history › prior-run-queue

Retrieves job information from the prior-run queue for CA 7 instance specified in path

#### Usage

zowe ca7 job-history prior-run-queue [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--jobname` | `--jn` (string)

  - The CA 7 job name

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Retrieves job information of JOBA from the prior-run queue for INSTANCE1:

  - `zowe ca7 job-history prior-run-queue --ca7Id INSTANCE1 --jn JOBA`

### zowe › ca7 › job-history › prior-run-queue › 1

Retrieves job information from the prior-run queue for DEFAULT_INSTANCE

#### Usage

zowe ca7 job-history prior-run-queue_1 [options]

#### Options

- `--jobname` | `--jn` (string)

  - The CA 7 job name

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Retrieves job information of JOBA from the prior-run queue for DEFAULT_INSTANCE:

  - `zowe ca7 job-history prior-run-queue_1 --jn JOBA`

## zowe › ca7 › job-instance

All the available commands listed in the Job Instance section.

### zowe › ca7 › job-instance › active-resource

Display active resources by job. The jobs can be listed generically or with fully qualified job names.

#### Usage

zowe ca7 job-instance active-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--job` (string)

  - (Optional) Specifies a fully qualified or generic job name.
    *
    Specifies all jobs.
    job
    Specifies a fully qualified job name
    Limits:: 1 to 8 alphanumeric characters job*
    Specifies multiple jobs that a generic job name specifies.
    Limits:: 1 to 7 alphanumeric characters that are terminated with an asterisk.

- `--resource-name` | `--rn` (string)

  - (Optional) Specifies a fully qualified or generic resource name.
    An asterisk indicates a generic request.
    *
    Specifies all resources.
    resource
    Specifies a fully qualified resource name.
    Limits::1 to 44 alphanumeric characters resource*
    Specifies multiple resources that a generic resource name specifies.
    Limits:: 1 to 43 alphanumeric characters that are terminated with an asterisk

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Display active resources by job RMTESTA1 along with other parameters:

  - `zowe ca7 job-instance active-resource --job RMTESTA1 --rn A --ca7Id INSTANCE1`

### zowe › ca7 › job-instance › active-resource › 1

Display active resources by job. The jobs can be listed generically or with fully qualified job names.

#### Usage

zowe ca7 job-instance active-resource_1 [options]

#### Options

- `--job` (string)

  - (Optional) Specifies a fully qualified or generic job name.
    *
    Specifies all jobs.
    job
    Specifies a fully qualified job name
    Limits:: 1 to 8 alphanumeric characters job*
    Specifies multiple jobs that a generic job name specifies.
    Limits:: 1 to 7 alphanumeric characters that are terminated with an asterisk.

- `--resource-name` | `--rn` (string)

  - (Optional) Specifies a fully qualified or generic resource name.
    An asterisk indicates a generic request.
    *
    Specifies all resources.
    resource
    Specifies a fully qualified resource name.
    Limits::1 to 44 alphanumeric characters resource*
    Specifies multiple resources that a generic resource name specifies.
    Limits:: 1 to 43 alphanumeric characters that are terminated with an asterisk

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Display active resources by job RMTESTA1 along with other parameters:

  - `zowe ca7 job-instance active-resource_1 --job RMTESTA1 --rn A`

### zowe › ca7 › job-instance › jcl

Displays JCL for a job in the active workload.

#### Usage

zowe ca7 job-instance jcl [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--ca7no` (string)

  - The CA 7 job number

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

- `--showNo` (boolean)

  - Show line numbers in JCL

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Retreives JCL of a CA7 job, CA75TEST (7777) which resided in CA7DB database for INSTANCE1:

  - `zowe ca7 job-instance jcl --ca7no 7777 --db CA7DB --showNo true --ca7Id INSTANCE1`

### zowe › ca7 › job-instance › jcl › 1

Displays JCL for a job in the active workload.

#### Usage

zowe ca7 job-instance jcl_1 [options]

#### Required Options

- `--ca7no` (string)

  - The CA 7 job number

#### Options

- `--databasename` | `--db` (string)

  - The CA 7 database name

- `--showNo` (boolean)

  - Show line numbers in JCL

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Retreives JCL of a CA7 job, CA75TEST (7777) which resided in CA7DB database:

  - `zowe ca7 job-instance jcl_1 --ca7no 7777 --db CA7DB --showNo true`

### zowe › ca7 › job-instance › list

Retrieves information about active jobs

#### Usage

zowe ca7 job-instance list [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--all` (boolean)

  - Fetch all the available properties
    If the job number is provided, all the properties will be returned

    Default value: false

#### Options

- `--ca7no` (string)

  - The CA 7 job number

- `--jobname` | `--jn` (string)

  - The CA 7 job name

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Retrieves information about active jobs for INSTANCE1:

  - `zowe ca7 job-instance list --all false --ca7no 777 --ca7Id INSTANCE1`

### zowe › ca7 › job-instance › list › 1

Retrieves information about active jobs

#### Usage

zowe ca7 job-instance list_1 [options]

#### Options

- `--ca7no` (string)

  - The CA 7 job number

- `--jobname` | `--jn` (string)

  - The CA 7 job name

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### Required Options

- `--all` (boolean)

  - Fetch all the available properties
    If the job number is provided, all the properties will be returned

    Default value: false

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Retrieves information about active jobs:

  - `zowe ca7 job-instance list_1 --all false --ca7no 777`

### zowe › ca7 › job-instance › list-custom

Displays information about jobs in the active workload.

#### Usage

zowe ca7 job-instance list-custom [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--ca7no` (string)

  - The CA 7 job number

- `--jobname` | `--jn` (string)

  - The CA 7 job name

- `--databasename` | `--db` (string)

  - The CA 7 database name

- `--job` (boolean)

  - The job name for this job in the active workload, 8 CHAR

- `--queueName` (boolean)

  - The name of the queue in which this job is currently located. Values are: 1=pre-processing; 2=request;3=ready; 4=active; 5=post-processing; 6=prior-run, CHAR 16

- `--ca7#` (boolean)

  - The job number for this job in the active workload

- `--status` (boolean)

  - The job status
    For more information about possible values refer to the LQ command.
    Note:
    This service determines values of status in much the same way as values are determined
    for the JOB STATUS column of the LQ command.
    The �LATE� value is an exception.
    Unlike the LQ command, this service will only evaluate and report late conditions when
    none of the other conditions are detected.
    For example, the LQ command output may report a status value of �LATE�
    even if the job is actually waiting for virtual resources.
    In such a case, this service will report �W-RSRC�.

- `--entryMode` (boolean)

  - Identifies how the job was brought into the queue.
    The possible values are the following:
    ARFJ
    Indicates an ARF recovery job.
    AUTO
    Indicates a triggered job.
    DEMD
    Indicates a demanded job.
    EXTL
    Indicates a job that is submitted external to CA WA CA 7 Edition
    LOAD
    Indicates a job to be loaded (brought in by the LOAD command).
    PS
    Indicates a job that the Personal Scheduling System submitted.
    RPET
    Indicates a repeated job.
    RUN
    Indicates a job that is brought in by the RUN command.
    SSCN
    Indicates a job that is brought in by schedule scan.
    XDEM
    Indicates a job brought in by the DEMAND command from an XPS client.
    XPS
    Indicates a job brought in from an XPS client using the RUN command with the REF option.
    XRUN
    Indicates a job brought in from an XPS client using the RUN command.

- `--abended` (boolean)

  - Y if job abended, N if not, 1 CHAR

- `--agentIntervention` | `--age` (boolean)

  - Y if INTERVENTION REQUIRED condition exists for this agent job, N if not, 1 CHAR

- `--agentJobNumber` | `--age` (boolean)

  - The job number/PID for this agent job, 28 CHAR

- `--agentName` (boolean)

  - The name of the agent where this job will execute, 16 CHAR

- `--agentStatus` | `--age` (boolean)

  - The status for this agent job, 40 CHAR

- `--agentStatusData` | `--age` (boolean)

  - Y if status data is available for this agent job,N if not, 1 CHAR

- `--agentSubmitted` | `--age` (boolean)

  - Y if agent job has been submitted to the agent, N if not, 1 CHAR

- `--agentType` (boolean)

  - Agent job type, zero if this is not an agent job, INTEGER

- `--agentUser` (boolean)

  - The userid with which this agent job will execute, 120 CHAR

- `--ajbBuildError` | `--ajb` (boolean)

  - Y if an error occurred while building an XPJOB job AJB or an agent job AFM, N if not, 1 CHAR

- `--arf` (boolean)

  - Y if this job is monitored by ARF, N if not

- `--arfAttachErr` | `--arf` (boolean)

  - Y if this job had an ARF attach error, N if not, 1 CHAR

- `--arfCompMatched` | `--arf` (boolean)

  - Set to Y if an ARF JOB completion rule matched for this job, 1 CHAR

- `--arfDate` (boolean)

  - Y if the job uses ARF. CA recommends using column ARF instead of this column, 1 CHAR

- `--arfErrorCond` | `--arf` (boolean)

  - Set to Y if there was an error during ARF condition detection, N if not, 1 CHAR

- `--arfjJob` (boolean)

  - Y if job is an ARF recovery job, N if not, 1 CHAR

- `--arfJobComplete` | `--arf` (boolean)

  - Set to Y if this job's completion has been posted to ARF, N if not, 1 CHAR

- `--arfRecovery` | `--arf` (boolean)

  - Y if job is in ARF recovery, N if not, 1 CHAR

- `--arfRecoveryErr` | `--arf` (boolean)

  - Y if this job had an error in ARF recovery, N if not, 1 CHAR

- `--arfset` (boolean)

  - The collection of ARF definitions that apply to this job, 8 CHAR

- `--arfTime` (boolean)

  - The date and time that the ARFSET was attached to this job, DATE/TIME

- `--autofDone` (boolean)

  - Y if job performed AUTO F, N if not, 1 CHAR

- `--ca11JesNode` | `--ca1` (boolean)

  - The JES node where this job executes, 8 CHAR

- `--ca11RestartStep` | `--ca1` (boolean)

  - The relative CA 11 restart step number, INTEGER

- `--ca11RmsCc` (boolean)

  - The CA 11 U11RMS step condition code, INTEGER

- `--ca11Subsystem` | `--ca1` (boolean)

  - The CA 11 subsystem name

- `--ca7System` (boolean)

  - The user-defined application system associated with this job, 8 CHAR

- `--compCode` (boolean)

  - The job completion code in number format, INTEGER

- `--cpmJfm` (boolean)

  - Y if JFM is used to track CPM, N if not, 1 CHAR

- `--cpuTableIndex` | `--cpu` (boolean)

  - Index to the CPU Table entry, SMALLINT

- `--cputime` (boolean)

  - This Job's average CPU time, PACKED

- `--currStepNum` | `--cur` (boolean)

  - The number of the step that is currently executing, INTEGER

- `--defNotFound` | `--def` (boolean)

  - Y if job defintion not found on database, N if not found, 1 CHAR

- `--doNotPrompt` | `--doN` (boolean)

  - Y if prompts are bypassed for the job, N if not, 1 CHAR

- `--drclass` (boolean)

  - The job's disaster recovery class, 8 CHAR

- `--drmode` (boolean)

  - Y if this job entered the queues when disaster recovery mode was active, N if not, 1 CHAR

- `--dueOutExists` | `--due` (boolean)

  - Determines if a zero value in DUE_OUT_TIME indicates midnight (Y) or no due out time (N), 1 CHAR

- `--dueOutTime` | `--due` (boolean)

  - The date and time this job is expected to complete, DATE/TIME

- `--dupJob` (boolean)

  - Y if a job with the same name is waiting on this job to complete, N if not, 1 CHAR

- `--dupJobWait` | `--dup` (boolean)

  - Y if this job is waiting on a job with the same name to complete, N if not, 1 CHAR

- `--elapsedTime` | `--ela` (boolean)

  - This Job's average elapsed time, PACKED

- `--endTime` (boolean)

  - The date and time this job ended, DATE/TIME

- `--executable` | `--exe` (boolean)

  - Y if job is executable, N if not, 1 CHAR

- `--express` (boolean)

  - Y if submission of this job has been expedited by use of the SUBMIT,EXPRESS=YES command, N if not, 1 CHAR

- `--externalInput` | `--ext` (boolean)

  - Y if we job has external input, N if not, 1 CHAR

- `--externalJob` | `--ext` (boolean)

  - Y if this is an externally tracked job, N if not, 1 CHAR

- `--externalSatisfied` | `--ext` (boolean)

  - The number of satisfied external requirements for this job, INTEGER

- `--externalTotal` | `--ext` (boolean)

  - The total number of external requirements for this job, INTEGER

- `--forcedComplete` | `--for` (boolean)

  - Y if job was force completed, N if not, 1 CHAR

- `--forcedSubmit` | `--for` (boolean)

  - Y if all input requirements have been marked as satisfied by use of the SUBMIT command, N if not, 1 CHAR

- `--fromXpRequest` | `--fro` (boolean)

  - Y if scheduling request for this job came from an XPS client, N if not, 1 CHAR

- `--hasCa11` (boolean)

  - Y if job has a CA11 segment, N if not, 1 CHAR

- `--hasCpuTime` | `--has` (boolean)

  - Y if we have non-zero CPU time for this job, N if not, 1 CHAR

- `--hasJo` (boolean)

  - Y if the JCL or PARM DATA contains a #JO card, N if not, 1 CHAR

- `--hasStepTime` | `--has` (boolean)

  - Y if job has non-zero step CPU time, N if not, 1 CHAR

- `--held` (boolean)

  - Y if job is held, N if not, 1 CHAR

- `--heldByJob` (boolean)

  - Y if job was held on entry to the queues, N if not, 1 CHAR

- `--heldSkeleton` | `--hel` (boolean)

  - Y if job is held and in skeleton status, N if not, 1 CHAR

- `--skeleton` (boolean)

  - Y if job is in skeleton status, N if not, 1 CHAR

- `--holdOnEntry` | `--hol` (boolean)

  - Y if job marked HOLD=YES, N if not, 1 CHAR

- `--hostName` (boolean)

  - The SMF Id of the system where this is executing, 8 CHAR

- `--inCpmFlow` (boolean)

  - Y if job is part of a CPM flow, N if not, 1 CHAR

- `--insertRms` (boolean)

  - Y if an RMS step will be inserted into this job's JCL, N if not, 1 CHAR

- `--jclAllocErr` | `--jcl` (boolean)

  - Y if JCL or PARM DATA library could not be allocated, N if not, 1 CHAR

- `--jclCount` (boolean)

  - The number of non-# records in the JCL or PARM DATA members associated with this job, INTEGER

- `--jclError` (boolean)

  - Y if job marked with JCL error, N if not, 1 CHAR

- `--jclFromAltlib` | `--jcl` (boolean)

  - Y if JCL or PARM DATA was retrieved from an alternate library, N if not, 1 CHAR

- `--jclLibrary` | `--jcl` (boolean)

  - Contains either a 3 digit JCL index value or a JCL variable beginning with an ampersand, 16 CHAR

- `--jesHi` (boolean)

  - JES supports ID > 99999, 1 CHAR

- `--loadOnly` (boolean)

  - Y if this is a LOAD only job, N if not, 1 CHAR

- `--loadStepDone` | `--loa` (boolean)

  - Y if LOAD step ran OK for this job, N if not, 1 CHAR

- `--locked` (boolean)

  - Y if job is locked, N if not, 1 CHAR

- `--longName` (boolean)

  - An alias name for this job. This name may be used by scheduling engines on other platforms, such as AutoSys, 64 CHAR

- `--lterm` (boolean)

  - Logical terminal name from job definition, 8 CHAR

- `--mainid` (boolean)

  - If positive, the CPU number on which the job may execute. If negative, the CPU number on which the job may not execute, INTEGER

- `--maint` (boolean)

  - Y if job ignores requirements, N if not, 1 CHAR

- `--manualRequeue` | `--man` (boolean)

  - Y if job has been re-queued to REQUEST queue, N if not, 1 CHAR

- `--memberName` | `--mem` (boolean)

  - The JCL or PARM DATA library member name, 8 CHAR

- `--mustStartExists` | `--mus` (boolean)

  - Determines if a zero value in MUST_START_TIME indicates midnight (Y) or no deadline time (N), 1 CHAR

- `--needsAutof` | `--nee` (boolean)

  - Y if a job changed and requires 'F' in CA11, N if not, 1 CHAR

- `--nextRunReq` | `--nex` (boolean)

  - Y if job has temporary requirements for the next execution, N if not, 1 CHAR

- `--nodeFailed` | `--nod` (boolean)

  - Y if this is an XPJOB job and at the time of it last submit its node was down, N if not, 1 CHAR

- `--nodeOffline` | `--nod` (boolean)

  - Y if this is an XPJOB job and at the time of its last submit its node was offline, N if not, 1 CHAR

- `--nodeStopped` | `--nod` (boolean)

  - Y if this is an XPJOB job and at the time of it last submit its node was stopped, N if not, 1 CHAR

- `--noUserId` (boolean)

  - Y if there is not a valid security id for this job, N if there is, 1 CHAR

- `--noXpsiParmlib` | `--noX` (boolean)

  - Y if this is an XPJOB job and has no PARMLIB, N if not, 1 CHAR

- `--noXpsiXpsparm` | `--noX` (boolean)

  - Y if this is an XPJOB job and has no PARM, N if not, 1 CHAR

- `--override` (boolean)

  - Y if JCL/PARM DATA override is required, N if not, 1 CHAR

- `--overrideApplied` | `--ove` (boolean)

  - Y if JCL overrides have been applied for this job, N if not, 1 CHAR

- `--prompt` (boolean)

  - Y if job should have LATE PROMPTS, N if not, 1 CHAR

- `--promptAck` (boolean)

  - Y if user has acknowledged the prompt, N if not, 1 CHAR

- `--prompted` (boolean)

  - Y if user has been prompted, N if not, 1 CHAR

- `--qjclUpdated` | `--qjc` (boolean)

  - Y if JCL or PARM DATA updated through QJCL, N if not, 1 CHAR

- `--queueJcl` (boolean)

  - Y if a QJCL command is in progress for this job N if not

- `--repeatCount` | `--rep` (boolean)

  - The number of times to repeat this job, INTEGER

- `--repeatDiff` | `--rep` (boolean)

  - The difference between the original dueout time and the original submit time, used by repeating jobs. The value is in minutes, INTEGER

- `--repeatInterval` | `--rep` (boolean)

  - The interval between repetitions of the job, PACKED

- `--repeatLeadTime` | `--rep` (boolean)

  - The lead time for this repeat job. This is the amount of time to ensure it completes before it due out time, PACKED

- `--repeatStopExists` | `--rep` (boolean)

  - Determines if a zero value in REPEAT_STOP_TIME indicates midnight (Y) or no repeat stop time (N), 1 CHAR

- `--repeatStopTime` | `--rep` (boolean)

  - The date and time on or after which a repeating job will not be repeated, DATE/TIME

- `--repeatType` | `--rep` (boolean)

  - The type of repeat job. This field determines how the submit time requierement is calculated for repeating jobs, 1 CHAR

- `--restartStep` | `--res` (boolean)

  - The step name in which the job was restarted, 8 CHAR

- `--retainJcl` (boolean)

  - Y if JCL or XPJOB information will be retained in the prior run queue, N if not, 1 CHAR

- `--rqmtCount` (boolean)

  - The master requirement count for this job. The number includes unsatisfied requirements, submit time, and other reasons preventing the job from being submitted, INTEGER

- `--schdAdjusted` | `--sch` (boolean)

  - Y if job's schedule has been adjusted, N if not, 1 CHAR

- `--nosecurity` | `--nos` (boolean)

  - Y if there was an error retrieving security data,N if no, 1 CHAR

- `--setNdb` (boolean)

  - Y if job will bypass LOAD processing at completion and not update the database, N if not, 1 CHAR

- `--smfNeeded` (boolean)

  - Y if SMF feedback is needed for this job, N if not, 1 CHAR

- `--startTime` (boolean)

  - The date and time this job started executing on its most recent submission, DATE/TIME

- `--submitted` (boolean)

  - Y if this job has been submitted to the host, N if not, 1 CHAR

- `--submitTime` | `--sub` (boolean)

  - The date and time this job was submitted, DATE/TIME

- `--triggered` (boolean)

  - Y if job triggered by another job, N if not, 1 CHAR

- `--uid` (boolean)

  - The CA 7 internal user security designation, INTEGER

- `--verify` (boolean)

  - Y if job has a manual verification requirement, N if not, 1 CHAR

- `--waitSubmitTime` | `--wai` (boolean)

  - Y if this job has a submit time requirement, N if not, 1 CHAR

- `--xpAltNode` (boolean)

  - The alternate node where this XPJOB job was routed, CHAR 64

- `--xpPrimaryNode` | `--xpP` (boolean)

  - The primary node associated with this XPJOB job, CHAR 64

- `--xpsJob` (boolean)

  - Y if this is an XPJOB job, N if not, 1 CHAR

- `--xpStatus` (boolean)

  - The status of the node associated with this XPJOB job. A: Active F: Failed CCI send O: Offline S:Stopped, 1 CHAR

- `--xtrackerInact` | `--xtr` (boolean)

  - Y if at time of submission, the XTRACKER task is not active for an XPJOB job or IAS is not active for an agent job, N if not, 1 CHAR

- `--xplatNode` (boolean)

  - Cross platform long node name, 64 CHAR

- `--responseError` | `--res` (boolean)

  - Response Error

- `--ca11FailingStep#` | `--ca1` (boolean)

  - CA 11 Failing Step Number, INTEGER

- `--completeOk` | `--com` (boolean)

  - Y if job completed normally, N if not, 1 CHAR

- `--jes#` (boolean)

  - The JES job number for this job. A value of -1 indicates *NA*, INTEGER

- `--needsLoad` (boolean)

  - Y if LOAD processing will be done for this job, Nif not, 1 CHAR

- `--deadline` (boolean)

  - The date and time a job must be started by in order to meet its due out time, DATE/TIME

- `--jclfrom254` | `--jcl` (boolean)

  - Y if JCL or XPJOB information will be retained in the prior run queue, N if not, 1 CHAR

- `--prose#` (boolean)

  - Number of the prose text associated with this job, or zero, INTEGER

- `--scheduleId` | `--sch` (boolean)

  - The schedule id for this execution, INTEGER

- `--triggeringJob#` | `--tri` (boolean)

  - The CA 7 internal job number of the job that triggered this job or job that created the data set that triggered this job, INTEGER

- `--triggers` (boolean)

  - Y if job can trigger other jobs, N if not, 1 CHAR

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- List a CA 7 job (7777) information which resided in CA7DB database :

  - `zowe ca7 job-instance list-custom --ca7no 7777 --db CA7DB --jobname TESTCA7`

### zowe › ca7 › job-instance › list-custom › 1

Displays information about jobs in the active workload.

#### Usage

zowe ca7 job-instance list-custom_1 [options]

#### Options

- `--ca7no` (string)

  - The CA 7 job number

- `--jobname` | `--jn` (string)

  - The CA 7 job name

- `--databasename` | `--db` (string)

  - The CA 7 database name

- `--job` (boolean)

  - The job name for this job in the active workload, 8 CHAR

- `--queueName` (boolean)

  - The name of the queue in which this job is currently located. Values are: 1=pre-processing; 2=request;3=ready; 4=active; 5=post-processing; 6=prior-run, CHAR 16

- `--ca7#` (boolean)

  - The job number for this job in the active workload

- `--status` (boolean)

  - The job status
    For more information about possible values refer to the LQ command.
    Note:
    This service determines values of status in much the same way as values are determined
    for the JOB STATUS column of the LQ command.
    The �LATE� value is an exception.
    Unlike the LQ command, this service will only evaluate and report late conditions when
    none of the other conditions are detected.
    For example, the LQ command output may report a status value of �LATE�
    even if the job is actually waiting for virtual resources.
    In such a case, this service will report �W-RSRC�.

- `--entryMode` (boolean)

  - Identifies how the job was brought into the queue.
    The possible values are the following:
    ARFJ
    Indicates an ARF recovery job.
    AUTO
    Indicates a triggered job.
    DEMD
    Indicates a demanded job.
    EXTL
    Indicates a job that is submitted external to CA WA CA 7 Edition
    LOAD
    Indicates a job to be loaded (brought in by the LOAD command).
    PS
    Indicates a job that the Personal Scheduling System submitted.
    RPET
    Indicates a repeated job.
    RUN
    Indicates a job that is brought in by the RUN command.
    SSCN
    Indicates a job that is brought in by schedule scan.
    XDEM
    Indicates a job brought in by the DEMAND command from an XPS client.
    XPS
    Indicates a job brought in from an XPS client using the RUN command with the REF option.
    XRUN
    Indicates a job brought in from an XPS client using the RUN command.

- `--abended` (boolean)

  - Y if job abended, N if not, 1 CHAR

- `--agentIntervention` | `--age` (boolean)

  - Y if INTERVENTION REQUIRED condition exists for this agent job, N if not, 1 CHAR

- `--agentJobNumber` | `--age` (boolean)

  - The job number/PID for this agent job, 28 CHAR

- `--agentName` (boolean)

  - The name of the agent where this job will execute, 16 CHAR

- `--agentStatus` | `--age` (boolean)

  - The status for this agent job, 40 CHAR

- `--agentStatusData` | `--age` (boolean)

  - Y if status data is available for this agent job,N if not, 1 CHAR

- `--agentSubmitted` | `--age` (boolean)

  - Y if agent job has been submitted to the agent, N if not, 1 CHAR

- `--agentType` (boolean)

  - Agent job type, zero if this is not an agent job, INTEGER

- `--agentUser` (boolean)

  - The userid with which this agent job will execute, 120 CHAR

- `--ajbBuildError` | `--ajb` (boolean)

  - Y if an error occurred while building an XPJOB job AJB or an agent job AFM, N if not, 1 CHAR

- `--arf` (boolean)

  - Y if this job is monitored by ARF, N if not

- `--arfAttachErr` | `--arf` (boolean)

  - Y if this job had an ARF attach error, N if not, 1 CHAR

- `--arfCompMatched` | `--arf` (boolean)

  - Set to Y if an ARF JOB completion rule matched for this job, 1 CHAR

- `--arfDate` (boolean)

  - Y if the job uses ARF. CA recommends using column ARF instead of this column, 1 CHAR

- `--arfErrorCond` | `--arf` (boolean)

  - Set to Y if there was an error during ARF condition detection, N if not, 1 CHAR

- `--arfjJob` (boolean)

  - Y if job is an ARF recovery job, N if not, 1 CHAR

- `--arfJobComplete` | `--arf` (boolean)

  - Set to Y if this job's completion has been posted to ARF, N if not, 1 CHAR

- `--arfRecovery` | `--arf` (boolean)

  - Y if job is in ARF recovery, N if not, 1 CHAR

- `--arfRecoveryErr` | `--arf` (boolean)

  - Y if this job had an error in ARF recovery, N if not, 1 CHAR

- `--arfset` (boolean)

  - The collection of ARF definitions that apply to this job, 8 CHAR

- `--arfTime` (boolean)

  - The date and time that the ARFSET was attached to this job, DATE/TIME

- `--autofDone` (boolean)

  - Y if job performed AUTO F, N if not, 1 CHAR

- `--ca11JesNode` | `--ca1` (boolean)

  - The JES node where this job executes, 8 CHAR

- `--ca11RestartStep` | `--ca1` (boolean)

  - The relative CA 11 restart step number, INTEGER

- `--ca11RmsCc` (boolean)

  - The CA 11 U11RMS step condition code, INTEGER

- `--ca11Subsystem` | `--ca1` (boolean)

  - The CA 11 subsystem name

- `--ca7System` (boolean)

  - The user-defined application system associated with this job, 8 CHAR

- `--compCode` (boolean)

  - The job completion code in number format, INTEGER

- `--cpmJfm` (boolean)

  - Y if JFM is used to track CPM, N if not, 1 CHAR

- `--cpuTableIndex` | `--cpu` (boolean)

  - Index to the CPU Table entry, SMALLINT

- `--cputime` (boolean)

  - This Job's average CPU time, PACKED

- `--currStepNum` | `--cur` (boolean)

  - The number of the step that is currently executing, INTEGER

- `--defNotFound` | `--def` (boolean)

  - Y if job defintion not found on database, N if not found, 1 CHAR

- `--doNotPrompt` | `--doN` (boolean)

  - Y if prompts are bypassed for the job, N if not, 1 CHAR

- `--drclass` (boolean)

  - The job's disaster recovery class, 8 CHAR

- `--drmode` (boolean)

  - Y if this job entered the queues when disaster recovery mode was active, N if not, 1 CHAR

- `--dueOutExists` | `--due` (boolean)

  - Determines if a zero value in DUE_OUT_TIME indicates midnight (Y) or no due out time (N), 1 CHAR

- `--dueOutTime` | `--due` (boolean)

  - The date and time this job is expected to complete, DATE/TIME

- `--dupJob` (boolean)

  - Y if a job with the same name is waiting on this job to complete, N if not, 1 CHAR

- `--dupJobWait` | `--dup` (boolean)

  - Y if this job is waiting on a job with the same name to complete, N if not, 1 CHAR

- `--elapsedTime` | `--ela` (boolean)

  - This Job's average elapsed time, PACKED

- `--endTime` (boolean)

  - The date and time this job ended, DATE/TIME

- `--executable` | `--exe` (boolean)

  - Y if job is executable, N if not, 1 CHAR

- `--express` (boolean)

  - Y if submission of this job has been expedited by use of the SUBMIT,EXPRESS=YES command, N if not, 1 CHAR

- `--externalInput` | `--ext` (boolean)

  - Y if we job has external input, N if not, 1 CHAR

- `--externalJob` | `--ext` (boolean)

  - Y if this is an externally tracked job, N if not, 1 CHAR

- `--externalSatisfied` | `--ext` (boolean)

  - The number of satisfied external requirements for this job, INTEGER

- `--externalTotal` | `--ext` (boolean)

  - The total number of external requirements for this job, INTEGER

- `--forcedComplete` | `--for` (boolean)

  - Y if job was force completed, N if not, 1 CHAR

- `--forcedSubmit` | `--for` (boolean)

  - Y if all input requirements have been marked as satisfied by use of the SUBMIT command, N if not, 1 CHAR

- `--fromXpRequest` | `--fro` (boolean)

  - Y if scheduling request for this job came from an XPS client, N if not, 1 CHAR

- `--hasCa11` (boolean)

  - Y if job has a CA11 segment, N if not, 1 CHAR

- `--hasCpuTime` | `--has` (boolean)

  - Y if we have non-zero CPU time for this job, N if not, 1 CHAR

- `--hasJo` (boolean)

  - Y if the JCL or PARM DATA contains a #JO card, N if not, 1 CHAR

- `--hasStepTime` | `--has` (boolean)

  - Y if job has non-zero step CPU time, N if not, 1 CHAR

- `--held` (boolean)

  - Y if job is held, N if not, 1 CHAR

- `--heldByJob` (boolean)

  - Y if job was held on entry to the queues, N if not, 1 CHAR

- `--heldSkeleton` | `--hel` (boolean)

  - Y if job is held and in skeleton status, N if not, 1 CHAR

- `--skeleton` (boolean)

  - Y if job is in skeleton status, N if not, 1 CHAR

- `--holdOnEntry` | `--hol` (boolean)

  - Y if job marked HOLD=YES, N if not, 1 CHAR

- `--hostName` (boolean)

  - The SMF Id of the system where this is executing, 8 CHAR

- `--inCpmFlow` (boolean)

  - Y if job is part of a CPM flow, N if not, 1 CHAR

- `--insertRms` (boolean)

  - Y if an RMS step will be inserted into this job's JCL, N if not, 1 CHAR

- `--jclAllocErr` | `--jcl` (boolean)

  - Y if JCL or PARM DATA library could not be allocated, N if not, 1 CHAR

- `--jclCount` (boolean)

  - The number of non-# records in the JCL or PARM DATA members associated with this job, INTEGER

- `--jclError` (boolean)

  - Y if job marked with JCL error, N if not, 1 CHAR

- `--jclFromAltlib` | `--jcl` (boolean)

  - Y if JCL or PARM DATA was retrieved from an alternate library, N if not, 1 CHAR

- `--jclLibrary` | `--jcl` (boolean)

  - Contains either a 3 digit JCL index value or a JCL variable beginning with an ampersand, 16 CHAR

- `--jesHi` (boolean)

  - JES supports ID > 99999, 1 CHAR

- `--loadOnly` (boolean)

  - Y if this is a LOAD only job, N if not, 1 CHAR

- `--loadStepDone` | `--loa` (boolean)

  - Y if LOAD step ran OK for this job, N if not, 1 CHAR

- `--locked` (boolean)

  - Y if job is locked, N if not, 1 CHAR

- `--longName` (boolean)

  - An alias name for this job. This name may be used by scheduling engines on other platforms, such as AutoSys, 64 CHAR

- `--lterm` (boolean)

  - Logical terminal name from job definition, 8 CHAR

- `--mainid` (boolean)

  - If positive, the CPU number on which the job may execute. If negative, the CPU number on which the job may not execute, INTEGER

- `--maint` (boolean)

  - Y if job ignores requirements, N if not, 1 CHAR

- `--manualRequeue` | `--man` (boolean)

  - Y if job has been re-queued to REQUEST queue, N if not, 1 CHAR

- `--memberName` | `--mem` (boolean)

  - The JCL or PARM DATA library member name, 8 CHAR

- `--mustStartExists` | `--mus` (boolean)

  - Determines if a zero value in MUST_START_TIME indicates midnight (Y) or no deadline time (N), 1 CHAR

- `--needsAutof` | `--nee` (boolean)

  - Y if a job changed and requires 'F' in CA11, N if not, 1 CHAR

- `--nextRunReq` | `--nex` (boolean)

  - Y if job has temporary requirements for the next execution, N if not, 1 CHAR

- `--nodeFailed` | `--nod` (boolean)

  - Y if this is an XPJOB job and at the time of it last submit its node was down, N if not, 1 CHAR

- `--nodeOffline` | `--nod` (boolean)

  - Y if this is an XPJOB job and at the time of its last submit its node was offline, N if not, 1 CHAR

- `--nodeStopped` | `--nod` (boolean)

  - Y if this is an XPJOB job and at the time of it last submit its node was stopped, N if not, 1 CHAR

- `--noUserId` (boolean)

  - Y if there is not a valid security id for this job, N if there is, 1 CHAR

- `--noXpsiParmlib` | `--noX` (boolean)

  - Y if this is an XPJOB job and has no PARMLIB, N if not, 1 CHAR

- `--noXpsiXpsparm` | `--noX` (boolean)

  - Y if this is an XPJOB job and has no PARM, N if not, 1 CHAR

- `--override` (boolean)

  - Y if JCL/PARM DATA override is required, N if not, 1 CHAR

- `--overrideApplied` | `--ove` (boolean)

  - Y if JCL overrides have been applied for this job, N if not, 1 CHAR

- `--prompt` (boolean)

  - Y if job should have LATE PROMPTS, N if not, 1 CHAR

- `--promptAck` (boolean)

  - Y if user has acknowledged the prompt, N if not, 1 CHAR

- `--prompted` (boolean)

  - Y if user has been prompted, N if not, 1 CHAR

- `--qjclUpdated` | `--qjc` (boolean)

  - Y if JCL or PARM DATA updated through QJCL, N if not, 1 CHAR

- `--queueJcl` (boolean)

  - Y if a QJCL command is in progress for this job N if not

- `--repeatCount` | `--rep` (boolean)

  - The number of times to repeat this job, INTEGER

- `--repeatDiff` | `--rep` (boolean)

  - The difference between the original dueout time and the original submit time, used by repeating jobs. The value is in minutes, INTEGER

- `--repeatInterval` | `--rep` (boolean)

  - The interval between repetitions of the job, PACKED

- `--repeatLeadTime` | `--rep` (boolean)

  - The lead time for this repeat job. This is the amount of time to ensure it completes before it due out time, PACKED

- `--repeatStopExists` | `--rep` (boolean)

  - Determines if a zero value in REPEAT_STOP_TIME indicates midnight (Y) or no repeat stop time (N), 1 CHAR

- `--repeatStopTime` | `--rep` (boolean)

  - The date and time on or after which a repeating job will not be repeated, DATE/TIME

- `--repeatType` | `--rep` (boolean)

  - The type of repeat job. This field determines how the submit time requierement is calculated for repeating jobs, 1 CHAR

- `--restartStep` | `--res` (boolean)

  - The step name in which the job was restarted, 8 CHAR

- `--retainJcl` (boolean)

  - Y if JCL or XPJOB information will be retained in the prior run queue, N if not, 1 CHAR

- `--rqmtCount` (boolean)

  - The master requirement count for this job. The number includes unsatisfied requirements, submit time, and other reasons preventing the job from being submitted, INTEGER

- `--schdAdjusted` | `--sch` (boolean)

  - Y if job's schedule has been adjusted, N if not, 1 CHAR

- `--nosecurity` | `--nos` (boolean)

  - Y if there was an error retrieving security data,N if no, 1 CHAR

- `--setNdb` (boolean)

  - Y if job will bypass LOAD processing at completion and not update the database, N if not, 1 CHAR

- `--smfNeeded` (boolean)

  - Y if SMF feedback is needed for this job, N if not, 1 CHAR

- `--startTime` (boolean)

  - The date and time this job started executing on its most recent submission, DATE/TIME

- `--submitted` (boolean)

  - Y if this job has been submitted to the host, N if not, 1 CHAR

- `--submitTime` | `--sub` (boolean)

  - The date and time this job was submitted, DATE/TIME

- `--triggered` (boolean)

  - Y if job triggered by another job, N if not, 1 CHAR

- `--uid` (boolean)

  - The CA 7 internal user security designation, INTEGER

- `--verify` (boolean)

  - Y if job has a manual verification requirement, N if not, 1 CHAR

- `--waitSubmitTime` | `--wai` (boolean)

  - Y if this job has a submit time requirement, N if not, 1 CHAR

- `--xpAltNode` (boolean)

  - The alternate node where this XPJOB job was routed, CHAR 64

- `--xpPrimaryNode` | `--xpP` (boolean)

  - The primary node associated with this XPJOB job, CHAR 64

- `--xpsJob` (boolean)

  - Y if this is an XPJOB job, N if not, 1 CHAR

- `--xpStatus` (boolean)

  - The status of the node associated with this XPJOB job. A: Active F: Failed CCI send O: Offline S:Stopped, 1 CHAR

- `--xtrackerInact` | `--xtr` (boolean)

  - Y if at time of submission, the XTRACKER task is not active for an XPJOB job or IAS is not active for an agent job, N if not, 1 CHAR

- `--xplatNode` (boolean)

  - Cross platform long node name, 64 CHAR

- `--responseError` | `--res` (boolean)

  - Response Error

- `--ca11FailingStep#` | `--ca1` (boolean)

  - CA 11 Failing Step Number, INTEGER

- `--completeOk` | `--com` (boolean)

  - Y if job completed normally, N if not, 1 CHAR

- `--jes#` (boolean)

  - The JES job number for this job. A value of -1 indicates *NA*, INTEGER

- `--needsLoad` (boolean)

  - Y if LOAD processing will be done for this job, Nif not, 1 CHAR

- `--deadline` (boolean)

  - The date and time a job must be started by in order to meet its due out time, DATE/TIME

- `--jclfrom254` | `--jcl` (boolean)

  - Y if JCL or XPJOB information will be retained in the prior run queue, N if not, 1 CHAR

- `--prose#` (boolean)

  - Number of the prose text associated with this job, or zero, INTEGER

- `--scheduleId` | `--sch` (boolean)

  - The schedule id for this execution, INTEGER

- `--triggeringJob#` | `--tri` (boolean)

  - The CA 7 internal job number of the job that triggered this job or job that created the data set that triggered this job, INTEGER

- `--triggers` (boolean)

  - Y if job can trigger other jobs, N if not, 1 CHAR

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- List a CA 7 job (7777) information which resided in CA7DB database :

  - `zowe ca7 job-instance list-custom_1 --ca7no 7777 --db CA7DB --jobname TESTCA7`

### zowe › ca7 › job-instance › list-waiting-resource

Display jobs waiting for resources.Show the resources that a job is waiting for when the job shows a status of W-RSRC on the List Queue (LQ) display.

#### Usage

zowe ca7 job-instance list-waiting-resource [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--job` (string)

  - (Optional) Specifies a fully qualified or generic job name.
    *
    Specifies all jobs.
    job
    Specifies a fully qualified job name
    Limits:: 1 to 8 alphanumeric characters job*
    Specifies multiple jobs that a generic job name specifies.
    Limits:: 1 to 7 alphanumeric characters that are terminated with an asterisk.

- `--schid` (string)

  - (Optional) A SCHID value of 0 applies to connections for all schedules and
    therefore is listed with connections for any schedule ID requested.
    Default:: Null (causes connections for all schedule IDs to appear)
    Limits:: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Display the resources that a job is waiting for on INSTANCE1:

  - `zowe ca7 job-instance list-waiting-resource --job JOBA --ca7Id INSTANCE1`

### zowe › ca7 › job-instance › list-waiting-resource › 1

Display jobs waiting for resources. Show the resources that a job is waiting for when the job shows a status of W-RSRC on the List Queue (LQ) display.

#### Usage

zowe ca7 job-instance list-waiting-resource_1 [options]

#### Options

- `--job` (string)

  - (Optional) Specifies a fully qualified or generic job name.
    *
    Specifies all jobs.
    job
    Specifies a fully qualified job name
    Limits:: 1 to 8 alphanumeric characters job*
    Specifies multiple jobs that a generic job name specifies.
    Limits:: 1 to 7 alphanumeric characters that are terminated with an asterisk.

- `--schid` (string)

  - (Optional) A SCHID value of 0 applies to connections for all schedules and
    therefore is listed with connections for any schedule ID requested.
    Default:: Null (causes connections for all schedule IDs to appear)
    Limits:: 1 to 3 numeric characters from 0 through 999

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Display the resources that a job is waiting for on DEFAULT INSTANCE:

  - `zowe ca7 job-instance list-waiting-resource_1 --job JOBA`

### zowe › ca7 › job-instance › requirements

Retrieves information about requirements for active jobs

#### Usage

zowe ca7 job-instance requirements [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--ca7no` (string)

  - The CA 7 job number, mutually exclusive with jobName

- `--jobName` | `--jn` (string)

  - The CA 7 job name, it can be masked. Mutually exclusive with ca7no

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Retrieves information about requirements for active jobs for INSTANCE1:

  - `zowe ca7 job-instance requirements --ca7no 777 --ca7Id INSTANCE1`

### zowe › ca7 › job-instance › requirements › 1

Retrieves information about requirements for active jobs

#### Usage

zowe ca7 job-instance requirements_1 [options]

#### Options

- `--ca7no` (string)

  - The CA 7 job number, mutually exclusive with jobName

- `--jobName` | `--jn` (string)

  - The CA 7 job name, it can be masked. Mutually exclusive with ca7no

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Retrieves information about requirements for active jobs:

  - `zowe ca7 job-instance requirements_1 --ca7no 777`

### zowe › ca7 › job-instance › update-jcl

Update JCL for an active job

#### Usage

zowe ca7 job-instance update-jcl [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--ca7no` (string)

  - The CA 7 job number

- `--sourcetype` | `--st` (string)

  - The source type containing the new JCL

- `--sourcedataset` | `--sd` (string)

  - The source data set name containing the new JCL

- `--sourcemember` | `--sm` (string)

  - The source data set member name containing the new JCL

#### Options

- `--postjclovrd` | `--jclovrd` (string)

  - Indicates whether to post the JCL override requirement when the JCL is updated

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Updates JCL of a CA7 job, CA75TEST (7777) with dataset details for INSTANCE1.:

  - `zowe ca7 job-instance update-jcl --ca7no 7777 --sd DATA.SET --sm MEMBER --st dataset --ca7Id INSTANCE1`

### zowe › ca7 › job-instance › update-jcl › 1

Update JCL for an active job

#### Usage

zowe ca7 job-instance update-jcl_1 [options]

#### Required Options

- `--ca7no` (string)

  - The CA 7 job number

- `--sourcetype` | `--st` (string)

  - The source type containing the new JCL

- `--sourcedataset` | `--sd` (string)

  - The source data set name containing the new JCL

- `--sourcemember` | `--sm` (string)

  - The source data set member name containing the new JCL

#### Options

- `--postjclovrd` | `--jclovrd` (string)

  - Indicates whether to post the JCL override requirement when the JCL is updated

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Updates JCL of a CA7 job, CA75TEST (7777) with dataset details:

  - `zowe ca7 job-instance update-jcl_1 --ca7no 7777 --sd DATA.SET --sm MEMBER --st dataset`

## zowe › ca7 › resources

Retrieve, add, update, or delete a CA 7 instance configuration, including the DEFAULT_INSTANCE

### zowe › ca7 › resources › delete-resource-count

Delete a Resource Count resource

#### Usage

zowe ca7 resources delete-resource-count [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--resource-name` | `--rn` (string)

  - Specifies the name of the Resource Count Resource to delete.
    Limits: 1 to 39 alphanumeric characters and periods

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Deletes a Resource Count resource PAYROLL.RCT from INSTANCE1:

  - `zowe ca7 resources delete-resource-count --ca7Id INSTANCE1 --rn PAYROLL.RCT`

### zowe › ca7 › resources › delete-resource-count › 1

ResourceCountResource_1

#### Usage

zowe ca7 resources delete-resource-count_1 [options]

#### Required Options

- `--resource-name` | `--rn` (string)

  - Specifies the name of the Resource Count Resource to delete.
    Limits: 1 to 39 alphanumeric characters and periods

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Deletes a Resource Count resource PAYROLL.RCT for DEFAULT_INSTANCE:

  - `zowe ca7 resources delete-resource-count_1 --rn PAYROLL.RCT`

### zowe › ca7 › resources › get-resource-count

Retrieves Resource Count resource information

#### Usage

zowe ca7 resources get-resource-count [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

#### Options

- `--resource` | `--rn` (string)

  - The resource name

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Retrieves Resource Count resource information for PAYROLL.RCT on INSTANCE1:

  - `zowe ca7 resources get-resource-count --rn PAYROLL.RCT --ca7Id INSTANCE1`

### zowe › ca7 › resources › get-resource-count › 1

ResourceCountResource_1

#### Usage

zowe ca7 resources get-resource-count_1 [options]

#### Options

- `--resource` | `--rn` (string)

  - The resource name

- `--databasename` | `--db` (string)

  - The CA 7 database name

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Retrieves Resource Count resource information for PAYROLL.RCT:

  - `zowe ca7 resources get-resource-count_1 --rn PAYROLL.RCT`

### zowe › ca7 › resources › post-resource-count

ResourceCountResource

#### Usage

zowe ca7 resources post-resource-count [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--resource-name` | `--rn` (string)

  - Specifies the name of the Resource Count Resource to add.
    Limits: 1 to 39 alphanumeric characters and periods

- `--total-count` | `--tc` (string)

  - Specifies the total number of available occurrences for this Resource Count Resource.
    Limits: 1 to 4 numeric characters in the range 0-9999

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Creates Resource Count resource information for PAYROLL.RCT on INSTANCE1:

  - `zowe ca7 resources post-resource-count --rn PAYROLL.RCT --tc 100 --ca7Id INSTANCE1`

### zowe › ca7 › resources › post-resource-count › 1

ResourceCountResource_1

#### Usage

zowe ca7 resources post-resource-count_1 [options]

#### Required Options

- `--resource-name` | `--rn` (string)

  - Specifies the name of the Resource Count Resource to add.
    Limits: 1 to 39 alphanumeric characters and periods

- `--total-count` | `--tc` (string)

  - Specifies the total number of available occurrences for this Resource Count Resource.
    Limits: 1 to 4 numeric characters in the range 0-9999

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Creates Resource Count resource information for PAYROLL.RCT:

  - `zowe ca7 resources post-resource-count_1 --rn PAYROLL.RCT --tc 100`

### zowe › ca7 › resources › update-resource-count

ResourceCountResource

#### Usage

zowe ca7 resources update-resource-count [options]

#### Required Options

- `--ca7Id` (string)

  - CA7ONL Instance

- `--resource-name` | `--rn` (string)

  - Specifies the name of the Resource Count Resource to update.
    Limits: 1 to 39 alphanumeric characters and periods

- `--total-count` | `--tc` (string)

  - Specifies the total number of available occurrences for this Resource Count Resource.
    Limits: 1 to 4 numeric characters in the range 0-9999

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Updates Resource Count resource information for PAYROLL.RCT on INSTANCE1:

  - `zowe ca7 resources update-resource-count --rn PAYROLL.RCT --tc 100 --ca7Id INSTANCE1`

### zowe › ca7 › resources › update-resource-count › 1

ResourceCountResource_1

#### Usage

zowe ca7 resources update-resource-count_1 [options]

#### Required Options

- `--resource-name` | `--rn` (string)

  - Specifies the name of the Resource Count Resource to update.
    Limits: 1 to 39 alphanumeric characters and periods

- `--total-count` | `--tc` (string)

  - Specifies the total number of available occurrences for this Resource Count Resource.
    Limits: 1 to 4 numeric characters in the range 0-9999

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Updates Resource Count resource information for PAYROLL.RCT to 100:

  - `zowe ca7 resources update-resource-count_1 --rn PAYROLL.RCT --tc 100`

## zowe › ca7 › transaction

Transaction operations

### zowe › ca7 › transaction › key

Retrieves a unique transaction key to be passed to any CA7Onl command.
The key will be used to ensure the same command is not sent twice.
After it is used in the payload of the initial request, the transaction key can only be used when reissuing the POST on the same endpoint, with the same payload.
Also note that the key will expire.
So it should not be used if more than 60 minutes have elapsed since the initial invocation.

#### Usage

zowe ca7 transaction key [options]

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Retrieves a unique transaction key to be used as command identifier:

  - `zowe ca7 transaction key`

## zowe › ca7 › version

Version information

### zowe › ca7 › version › version

Product Version
The CA 7 Rest API version
CA 7 Supported Version
The CA 7 supported version
Build Number
The build number
Build Time
The date and time when the build was done, GMT

#### Usage

zowe ca7 version version [options]

#### CA7 Connection Options

- `--host` | `-H` (string)

  - Host name of the CA7 API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the CA7 API service that is running on the mainframe system.

- `--user` | `-u` (string)

  - User name for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the CA7 API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` | `-o` (string)

  - Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

#### Profile Options

- `--ca7-profile` | `--ca7-p` (string)

  - The name of a (ca7) 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

- `--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

- Retrieves CA 7 REST API version information:

  - `zowe ca7 version version`

## zowe › cics

Interact with IBM CICS programs and transactions.

## zowe › cics › add-to-list

Add new resources (for example, CSD Groups to CSD Lists) to CICS through IBM CMCI.

### zowe › cics › add-to-list › csdGroup

Add a CSD Group to a CICS CSD List.

#### Usage

zowe cics add-to-list csdGroup <name> <csdList> [options]

#### Positional Arguments

- `name` (string)

  - The name of the CSD Group to add. The maximum length of the CSD Group name is eight characters

- `csdList` (string)

  - The name of the CSD List to add the group to. The maximum length of the CSD List name is eight characters

#### Options

- `--region-name` (string)

  - The CICS region name to which to add the CSD Group to the CSD List

- `--cics-plex` (string)

  - The name of the CICSPlex to which to add the CSD Group to the CSD List

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Add the CSD Group MYGRP to the CSD List MYLIST in the region named MYREG:

  - `zowe cics add-to-list csdGroup MYGRP MYLIST --region-name MYREG`

## zowe › cics › define

Define new resources (for example, programs) to CICS through IBM CMCI.

### zowe › cics › define › bundle

Define a new bundle to CICS.

#### Usage

zowe cics define bundle <bundleName> <bundleDir> <csdGroup> [options]

#### Positional Arguments

- `bundleName` (string)

  - The name of the new bundle to define. The maximum length of the bundle name is eight characters.

- `bundleDir` (string)

  - The fully qualified name of the root directory for the bundle on z/OS UNIX. The first character must be / and the end character /. The maximum length is 255 characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the new bundle that you want to define. The maximum length of the group name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name to which to define the new bundle

- `--cics-plex` (string)

  - The name of the CICSplex to which to define the new bundle

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Define a bundle named BND123 to the region name MYREGION in the CSD group MYGRP:

  - `zowe cics define bundle BND123 /user/myname/bundle1/ MYGRP --region-name MYREGION`

### zowe › cics › define › program

Define a new program to CICS.

#### Usage

zowe cics define program <programName> <csdGroup> [options]

#### Positional Arguments

- `programName` (string)

  - The name of the new program to define. The maximum length of the program name is eight characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the new program that you want to define. The maximum length of the group name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name to which to define the new program

- `--cics-plex` (string)

  - The name of the CICSPlex to which to define the new program

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Define a program named PGM123 to the region name MYREGION in the CSD group MYGRP:

  - `zowe cics define program PGM123 MYGRP --region-name MYREGION`

### zowe › cics › define › transaction

Define a new transaction to CICS.

#### Usage

zowe cics define transaction <transactionName> <programName> <csdGroup> [options]

#### Positional Arguments

- `transactionName` (string)

  - The name of the new transaction to define. The maximum length of the transaction name is four characters.

- `programName` (string)

  - The name of the program that the transaction uses. The maximum length of the program name is eight characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the new transaction that you want to define. The maximum length of the group name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name to which to define the new transaction

- `--cics-plex` (string)

  - The name of the CICSPlex to which to define the new transaction

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Define a transaction named TRN1 for the program named PGM123 to the region named MYREGION in the CSD group MYGRP:

  - `zowe cics define transaction TRN1 PGM123 MYGRP --region-name MYREGION`

### zowe › cics › define › urimap-client

Define a new URIMAP of type client to CICS. This acts as an HTTP(S) client

#### Usage

zowe cics define urimap-client <urimapName> <csdGroup> [options]

#### Positional Arguments

- `urimapName` (string)

  - The name of the URIMAP to create. The maximum length of the urimap name is eight characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the new urimap that you want to define. The maximum length of the group name is eight characters.

#### Required Options

- `--urimap-path` | `--up` (string)

  - The path component of the URI.

- `--urimap-host` | `--uh` (string)

  - The host component of the URI.

#### Options

- `--urimap-scheme` | `--us` (string)

  - The scheme component to be used with the request (http or https).

    Default value: https
    Allowed values: http, https

- `--authenticate` | `--auth` (string)

  - The authentication and identification scheme to be used for client URIMAPs.

    Allowed values: NO, BASIC

- `--certificate` | `--cert` (string)

  - The label of a certificate in the keyring that is to be used as the client certificate in SSL handshakes

- `--description` | `--desc` (string)

  - Description of the URIMAP resource being defined.

- `--region-name` (string)

  - The CICS region name to which to define the new URIMAP.

- `--cics-plex` (string)

  - The name of the CICSPlex to which to define the new URIMAP.

- `--enable` (boolean)

  - Whether or not the URIMAP is to be enabled on install by default.

    Default value: true

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Define a URIMAP named URIMAPA to the region named MYREGION in the CSD group MYGRP where the host is www.example.com and the path is /example/index.html:

  - `zowe cics define urimap-client URIMAPA MYGRP --urimap-path /example/index.html --urimap-host www.example.com --region-name MYREGION`

### zowe › cics › define › urimap-pipeline

Define a new URIMAP of type pipeline to CICS. This processes incoming HTTP(S) requests

#### Usage

zowe cics define urimap-pipeline <urimapName> <csdGroup> [options]

#### Positional Arguments

- `urimapName` (string)

  - The name of the URIMAP to create. The maximum length of the urimap name is eight characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the new urimap that you want to define. The maximum length of the group name is eight characters.

#### Required Options

- `--urimap-path` | `--up` (string)

  - The path component of the URI.

- `--urimap-host` | `--uh` (string)

  - The host component of the URI.

- `--pipeline-name` | `--pn` (string)

  - The name of the PIPELINE resource definition for the URIMAP. The maximum length of the pipeline name is eight characters.

#### Options

- `--urimap-scheme` | `--us` (string)

  - The scheme component to be used with the request (http or https).

    Default value: https
    Allowed values: http, https

- `--description` | `--desc` (string)

  - Description of the URIMAP resource being defined.

- `--transaction-name` | `--tn` (string)

  - The name of the TRANSACTION resource definition for the URIMAP. The maximum length of the transaction name is four characters.

- `--webservice-name` | `--wn` (string)

  - The name of the WEBSERVICE resource definition for the URIMAP. The maximum length of the transaction name is 32 characters.

- `--tcpipservice` | `--tcpip` (string)

  - The TCPIPSERVICE to which the URIMAP definition applies.

- `--region-name` (string)

  - The CICS region name to which to define the new URIMAP.

- `--cics-plex` (string)

  - The name of the CICSPlex to which to define the new URIMAP.

- `--enable` (boolean)

  - Whether or not the URIMAP is to be enabled on install by default.

    Default value: true

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Define a URIMAP named URIMAPA for the pipeline named PIPE123 to the region named MYREGION in the CSD group MYGRP where the host is www.example.com and the path is /example/index.html:

  - `zowe cics define urimap-pipeline URIMAPA MYGRP --urimap-path /example/index.html --urimap-host www.example.com --pipeline-name PIPE123 --region-name MYREGION`

### zowe › cics › define › urimap-server

Define a new URIMAP of type server to CICS. This acts as an HTTP(S) server

#### Usage

zowe cics define urimap-server <urimapName> <csdGroup> [options]

#### Positional Arguments

- `urimapName` (string)

  - The name of the URIMAP to create. The maximum length of the urimap name is eight characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the new urimap that you want to define. The maximum length of the group name is eight characters.

#### Required Options

- `--urimap-path` | `--up` (string)

  - The path component of the URI.

- `--urimap-host` | `--uh` (string)

  - The host component of the URI.

- `--program-name` | `--pn` (string)

  - The application program that makes or handles the requests.

#### Options

- `--urimap-scheme` | `--us` (string)

  - The scheme component to be used with the request (http or https).

    Default value: https
    Allowed values: http, https

- `--description` | `--desc` (string)

  - Description of the URIMAP resource being defined.

- `--tcpipservice` | `--tcpip` (string)

  - The TCPIPSERVICE to which the URIMAP definition applies.

- `--region-name` (string)

  - The CICS region name to which to define the new URIMAP.

- `--cics-plex` (string)

  - The name of the CICSPlex to which to define the new URIMAP.

- `--enable` (boolean)

  - Whether or not the URIMAP is to be enabled on install by default.

    Default value: true

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Define a URIMAP named URIMAPA for the program named PGM123 to the region named MYREGION in the CSD group MYGRP where the host is www.example.com and the path is /example/index.html:

  - `zowe cics define urimap-server URIMAPA MYGRP --urimap-path /example/index.html --urimap-host www.example.com --program-name PGM123 --region-name MYREGION`

### zowe › cics › define › webservice

Define a new web service to CICS.

#### Usage

zowe cics define webservice <webserviceName> <csdGroup> [options]

#### Positional Arguments

- `webserviceName` (string)

  - The name of the WEBSERVICE to create. The maximum length of the web service name is eight characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the new web service that you want to define. The maximum length of the group name is eight characters.

#### Required Options

- `--pipeline-name` | `--pn` (string)

  - The name of the PIPELINE resource definition for the web service. The maximum length of the pipeline name is eight characters

- `--wsbind` (string)

  - The file name of the web service binding file on HFS.

#### Options

- `--description` | `--desc` (string)

  - Description of the web service resource being defined.

- `--validation` (boolean)

  - Specifies whether full validation of SOAP messages against the corresponding schema in the web service description should be performed at run time.

    Default value: false

- `--wsdlfile` | `--wsdl` (string)

  - The file name of the web service description (WSDL) file on HFS.

- `--region-name` (string)

  - The CICS region name to which to define the new web service.

- `--cics-plex` (string)

  - The name of the CICSPlex to which to define the new web service.

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Define a webservice named WEBSVCA for the pipeline named PIPE123 to the region named MYREGION in the CSD group MYGRP where the binding file is /u/exampleapp/wsbind/example.log:

  - `zowe cics define webservice WEBSVCA MYGRP --pipeline-name PIPELINE --wsbind /u/exampleapp/wsbind/example.log --region-name MYREGION`

## zowe › cics › delete

Delete resources (for example, programs) from CICS through IBM CMCI.

### zowe › cics › delete › program

Delete a program from CICS.

#### Usage

zowe cics delete program <programName> <csdGroup> [options]

#### Positional Arguments

- `programName` (string)

  - The name of the program to delete. The maximum length of the program name is eight characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the program that you want to delete. The maximum length of the group name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name from which to delete the program

- `--cics-plex` (string)

  - The name of the CICSPlex from which to delete the program

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Delete a program named PGM123 from the region named MYREGION:

  - `zowe cics delete program PGM123 --region-name MYREGION`

### zowe › cics › delete › transaction

Delete a transaction from CICS.

#### Usage

zowe cics delete transaction <transactionName> <csdGroup> [options]

#### Positional Arguments

- `transactionName` (string)

  - The name of the transaction to delete. The maximum length of the transaction name is four characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the transaction that you want to delete. The maximum length of the group name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name from which to delete the transaction

- `--cics-plex` (string)

  - The name of the CICSPlex from which to delete the transaction

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Delete a transaction named TRN1 from the region named MYREGION:

  - `zowe cics delete transaction TRN1 MYGRP --region-name MYREGION`

### zowe › cics › delete › urimap

Delete a urimap from CICS.

#### Usage

zowe cics delete urimap <urimapName> <csdGroup> [options]

#### Positional Arguments

- `urimapName` (string)

  - The name of the urimap to delete. The maximum length of the urimap name is eight characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the urimap that you want to delete. The maximum length of the group name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name from which to delete the urimap

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Delete a urimap named URIMAPA from the region named MYREGION belonging to the csdgroup MYGRP:

  - `zowe cics delete urimap URIMAPA MYGRP --region-name MYREGION`

### zowe › cics › delete › webservice

Delete a web service from CICS.

#### Usage

zowe cics delete webservice <webserviceName> <csdGroup> [options]

#### Positional Arguments

- `webserviceName` (string)

  - The name of the web service to delete. The maximum length of the web service name is eight characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the web service that you want to delete. The maximum length of the group name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name from which to delete the web service

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Delete a web service named WEBSVCA from the region named MYREGION belonging to the csdgroup MYGRP:

  - `zowe cics delete webservice WEBSVCA MYGRP --region-name MYREGION`

## zowe › cics › disable

Disable resources (for example, urimaps) from CICS through IBM CMCI.

### zowe › cics › disable › urimap

Disable a urimap from CICS.

#### Usage

zowe cics disable urimap <urimapName> [options]

#### Positional Arguments

- `urimapName` (string)

  - The name of the urimap to disable. The maximum length of the urimap name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name in which to disable the urimap

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Disable a urimap named URIMAPA from the region named MYREGION:

  - `zowe cics disable urimap URIMAPA --region-name MYREGION`

## zowe › cics › discard

Discard resources (for example, programs) from CICS through IBM CMCI.

### zowe › cics › discard › program

Discard a program from CICS.

#### Usage

zowe cics discard program <programName> [options]

#### Positional Arguments

- `programName` (string)

  - The name of the program to discard. The maximum length of the program name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name from which to discard the program

- `--cics-plex` (string)

  - The name of the CICSPlex from which to discard the program

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Discard a program named PGM123 from the region named MYREGION:

  - `zowe cics discard program PGM123 --region-name MYREGION`

### zowe › cics › discard › transaction

Discard a transaction from CICS.

#### Usage

zowe cics discard transaction <transactionName> [options]

#### Positional Arguments

- `transactionName` (string)

  - The name of the transaction to discard. The maximum length of the transaction name is four characters.

#### Options

- `--region-name` (string)

  - The CICS region name from which to discard the transaction

- `--cics-plex` (string)

  - The name of the CICSPlex from which to discard the transaction

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Discard a transaction named TRN1 from the region named MYREGION:

  - `zowe cics discard transaction TRN1 --region-name MYREGION`

### zowe › cics › discard › urimap

Discard a urimap from CICS.

#### Usage

zowe cics discard urimap <urimapName> [options]

#### Positional Arguments

- `urimapName` (string)

  - The name of the urimap to discard. The maximum length of the urimap name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name from which to discard the urimap

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Discard a urimap named URIMAPA from the region named MYREGION:

  - `zowe cics discard urimap URIMAPA --region-name MYREGION`

## zowe › cics › enable

Enable resources (for example, urimaps) from CICS through IBM CMCI.

### zowe › cics › enable › urimap

Enable a urimap from CICS.

#### Usage

zowe cics enable urimap <urimapName> [options]

#### Positional Arguments

- `urimapName` (string)

  - The name of the urimap to enable. The maximum length of the urimap name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name in which to enable the urimap

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Enable a urimap named URIMAPA from the region named MYREGION:

  - `zowe cics enable urimap URIMAPA --region-name MYREGION`

## zowe › cics › get

Get resources (for example, programs or transactions) from CICS through IBM CMCI.

### zowe › cics › get › resource

Get resources (for example, programs or transactions) from CICS.

#### Usage

zowe cics get resource <resourceName> [options]

#### Positional Arguments

- `resourceName` (string)

  - The name of the resource to get.

#### Options

- `--region-name` | `--rn` (string)

  - The CICS region name from which to get the resources

- `--cics-plex` | `--cp` (string)

  - The name of the CICSPlex from which to get the resources

- `--criteria` | `-c` (string)

  - The criteria by which to filter the resource

- `--parameter` | `-p` (string)

  - The parameter by which to refine the resource

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Get program resources from the region named MYREGION:

  - `zowe cics get resource CICSProgram --region-name MYREGION`

- Get local transaction resources from the region named MYREGION:

  - `zowe cics get resource CICSLocalTransaction --region-name MYREGION`

- Get local file resources from the region named MYREGION:

  - `zowe cics get resource CICSLocalFile --region-name MYREGION`

- Get program definition resources from the CSD group named GRP1 and the region named MYREGION:

  - `zowe cics get resource CICSDefinitionProgram --region-name MYREGION --parameter "CSDGROUP(GRP1)"`

- Get transaction definition resources from the CSD group named GRP1 and the region named MYREGION:

  - `zowe cics get resource CICSDefinitionTransaction --region-name MYREGION --parameter "CSDGROUP(GRP1)"`

- Get URIMap definition resources from the CSD group named GRP1 and the region named MYREGION:

  - `zowe cics get resource CICSDefinitionURIMap --region-name MYREGION --parameter "CSDGROUP(GRP1)"`

- Get program resources that start with the name PRG from the region named MYREGION:

  - `zowe cics get resource CICSProgram --region-name MYREGION --criteria "PROGRAM=PRG*"`

- Get a local transaction resource named TRAN from the region named MYREGION:

  - `zowe cics get resource CICSLocalTransaction --region-name MYREGION --criteria "TRANID=TRAN"`

- Get program resources that start with the name MYPRG from the region named MYREGION and display various fields as a table:

  - `zowe cics get resource CICSProgram --region-name MYREGION --criteria "PROGRAM=MYPRG*" --rft table --rfh --rff program length status`

## zowe › cics › install

Install resources (for example, programs) to CICS through IBM CMCI.

### zowe › cics › install › program

Install a program to CICS.

#### Usage

zowe cics install program <programName> <csdGroup> [options]

#### Positional Arguments

- `programName` (string)

  - The name of the program to install. The maximum length of the program name is eight characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the program that you want to install. The maximum length of the group name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name to which to install the program

- `--cics-plex` (string)

  - The name of the CICSPlex to which to install the program

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Install a program named PGM123 to the region named MYREGION in the CSD group MYGRP:

  - `zowe cics install program PGM123 MYGRP --region-name MYREGION`

### zowe › cics › install › transaction

Install a transaction to CICS.

#### Usage

zowe cics install transaction <transactionName> <csdGroup> [options]

#### Positional Arguments

- `transactionName` (string)

  - The name of the transaction to install. The maximum length of the transaction name is four characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the transaction that you want to install. The maximum length of the group name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name to which to install the transaction

- `--cics-plex` (string)

  - The name of the CICSPlex to which to install the transaction

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Install a transaction named TRN1 to the region named MYREGION in the CSD group MYGRP:

  - `zowe cics install transaction TRN1 MYGRP --region-name MYREGION`

### zowe › cics › install › urimap

Install a urimap to CICS.

#### Usage

zowe cics install urimap <urimapName> <csdGroup> [options]

#### Positional Arguments

- `urimapName` (string)

  - The name of the urimap to install. The maximum length of the urimap name is eight characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the urimap that you want to install. The maximum length of the group name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name to which to install the urimap

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Install a urimap named URIMAPA to the region named MYREGION belonging to the csdgroup MYGRP:

  - `zowe cics install urimap URIMAPA CSDGROUP --region-name MYREGION`

## zowe › cics › refresh

Refresh a program on CICS through IBM CMCI.

### zowe › cics › refresh › program

Refresh a program on CICS.

#### Usage

zowe cics refresh program <programName> [options]

#### Positional Arguments

- `programName` (string)

  - The name of the program to refresh. The maximum length of the program name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name on which you want to refresh the program

- `--cics-plex` (string)

  - The name of the CICSPlex on which to refresh the program

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Refresh a program named PGM123 from the region named MYREGION:

  - `zowe cics refresh program PGM123 --region-name MYREGION`

## zowe › cics › remove-from-list

Remove resources (for example, CSD Groups in CSD Lists) from CICS through IBM CMCI.

### zowe › cics › remove-from-list › csdGroup

Remove a CSD Group from a CICS CSD List.

#### Usage

zowe cics remove-from-list csdGroup <name> <csdList> [options]

#### Positional Arguments

- `name` (string)

  - The name of the CSD Group to remove. The maximum length of the CSD Group name is eight characters

- `csdList` (string)

  - The name of the CSD List to remove the group from. The maximum length of the CSD List name is eight characters

#### Options

- `--region-name` (string)

  - The CICS region name to which to remove the CSD Group from the CSD List

- `--cics-plex` (string)

  - The name of the CICSPlex to which to remove the CSD Group from the CSD List

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--cics-profile` | `--cics-p` (string)

  - The name of a (cics) 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

- `--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

- Remove the CSD Group MYGRP from the CSD List MYLIST in the region named MYREG:

  - `zowe cics remove-from-list csdGroup MYGRP MYLIST --region-name MYREG`

## zowe › config

Manage JSON project and global configuration.

### zowe › config › auto-init

Automatically generate a config from APIML.

#### Usage

zowe config auto-init [options]

#### Automatic Config Initialization Options

- `--user-config` | `--uc` (boolean)

  - Save config in the user layer

    Default value: false

- `--global-config` | `--gc` (boolean)

  - Save config in the global layer

    Default value: false

- `--dry-run` | `--dr` | `--dry` (boolean)

  - Display the outcome of the initialization without saving

- `--edit` | `-e` (boolean)

  - Open in editor after initializing the configuration

- `--overwrite` | `--ow` (boolean)

  - Replaces an existing configuration with a new configuration

    Default value: false

- `--for-sure` | `-f` (boolean)

  - Confirms the overwrite option

    Default value: false

#### Options

- `--editor` | `--ed` (string)

  - Editor that overrides the default editor for this file type. Set the option to the editor's executable file location or the program's name: ie "--editor notepad"

#### APIML Connection Options

- `--host` | `-H` (string)

  - Host name of the mainframe running the API Mediation Layer.

- `--port` | `-P` (number)

  - Port number of API Mediation Layer on the mainframe.

- `--user` | `-u` (string)

  - User name to authenticate to the API Mediation Layer on the mainframe.

- `--password` | `--pass` | `--pw` (string)

  - Password to authenticate to the API Mediation Layer 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 Mediation Layer. 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 Mediation Layer.

- `--cert-file` (local file path)

  - The file path to a certificate file to use to authenticate to the API Mediation Layer

- `--cert-key-file` (local file path)

  - The file path to a certificate key file to use to authenticate to the API Mediation Layer

#### Profile Options

- `--base-profile` | `--base-p` (string)

  - The name of a (base) profile to load for this command execution.

### zowe › config › convert-profiles

Convert v1 profiles to a global zowe.config.json file.

#### Usage

zowe config convert-profiles [options]

#### Options

- `--prompt` (boolean)

  - Prompt for confirmation. Use --no-prompt to disable prompting.

    Default value: true

- `--delete` (boolean)

  - Delete the existing profiles on disk and any securely stored secrets.

#### Examples

- Convert V1 profiles to a new Zowe client configuration without prompting:

  - `zowe config convert-profiles --no-prompt`

- Convert V1 profiles to a new Zowe client configuration and delete the old V1 profiles:

  - `zowe config convert-profiles --delete`

### zowe › config › edit

Edit an existing config file in your system's default text editor.

In a graphical environment, the application associated with JSON files will be launched. In a command-line environment, vi will be launched. To override the command-line editor used, specify it with the --editor option.

#### Usage

zowe config edit [options]

#### Options

- `--global-config` | `--gc` (boolean)

  - Target the global config files.

    Default value: false

- `--user-config` | `--uc` (boolean)

  - Target the user config files.

    Default value: false

- `--editor` | `--ed` (string)

  - Editor that overrides the default editor for this file type. Set the option to the editor's executable file location or the program's name: ie "--editor notepad".

#### Examples

- Edit global config file:

  - `zowe config edit --global-config`

### zowe › config › import

Import config files from another location on disk or from an Internet URL.

If the config `$schema` property points to a relative path, the schema will also be imported.

#### Usage

zowe config import <location> [options]

#### Positional Arguments

- `location` (string)

  - File path or URL to import from.

#### Options

- `--global-config` | `--gc` (boolean)

  - Target the global config files.

    Default value: false

- `--user-config` | `--uc` (boolean)

  - Target the user config files.

    Default value: false

- `--overwrite` | `--ow` (boolean)

  - Overwrite config file if one already exists.

    Default value: false

#### Connection Options

- `--user` | `-u` (string)

  - User name if authentication is required to download the config from a URL.

- `--password` | `--pass` | `--pw` (string)

  - Password if authentication is required to download the config from a URL.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates if config is downloaded from an HTTPS URL.

    Default value: true

#### Examples

- Import config from local file on disk:

  - `zowe config import ~/Downloads/zowe.config.json`

- Import global config from Internet URL:

  - `zowe config import https://example.com/zowe.config.json --global-config`

### zowe › config › init

Initialize config files. Defaults to initializing "zowe.config.json" in the current working directory unless otherwise specified.

Use "--user-config" to init "zowe.config.user.json". Use "--global-config" to initialize the configuration files in your home "~/.zowe" directory.

Use "--no-prompt" to skip prompting for values in a CI environment.

#### Usage

zowe config init [options]

#### Options

- `--global-config` | `--gc` (boolean)

  - Target the global config files.

    Default value: false

- `--user-config` | `--uc` (boolean)

  - Target the user config files.

    Default value: false

- `--prompt` (boolean)

  - Prompt for missing values in the base profile. Useful for disabling prompting in CI environments.

    Default value: true

- `--overwrite` | `--ow` (boolean)

  - Replace existing config files instead of merging the new changes.

- `--for-sure` | `--fs` (boolean)

  - Confirms the overwrite option.

    Default value: false

- `--dry-run` | `--dr` | `--dry` (boolean)

  - Display the outcome of the initialization without saving it.

- `--edit` | `-e` (boolean)

  - Open in editor after initializing the configuration.

- `--editor` | `--ed` (string)

  - Editor that overrides the default editor for this file type. Set the option to the editor's executable file location or the program's name: ie "--editor notepad".

#### Examples

- Initialize configuration files in your home "~/.zowe" directory:

  - `zowe config init --global-config`

- Do a dry run of initializing configuration files in your home "~/.zowe" directory:

  - `zowe config init --global-config --dry-run`

- Initialize the user config files:

  - `zowe config init --user-config`

- Initialize the user config files and do not prompt for secure values:

  - `zowe config init --user-config --prompt false`

- Do a dry run of initializing the user config files and do not prompt for secure values:

  - `zowe config init --user-config --prompt false --dry-run`

- Overwrite any existing global config files:

  - `zowe config init --global-config --overwrite --for-sure`

- Overwrite any existing user config files:

  - `zowe config init --user-config --overwrite --for-sure`

### zowe › config › list

List config properties.

#### Usage

zowe config list [property] [options]

#### Positional Arguments

- `property` (string)

  - The config property to list. Blank to list all properties.

#### Options

- `--locations` (boolean)

  - Separate the config properties into their respective config file locations. Helpful to determine where configuration value is specified.

- `--name-only` | `--root` (boolean)

  - List only the names of root level property names. For example, specify in addition to '--locations' to get a list of config file paths only.

#### Examples

- List property names for a specified config property:

  - `zowe config list "defaults"`

- List only root level property names for a specified config property:

  - `zowe config list "defaults" --name-only`

- List config properties by separating them by their respective config file locations:

  - `zowe config list --locations`

- List only the root level configuration property names:

  - `zowe config list --name-only`

- List only the root level configuration property names by separating them by their respective config file locations:

  - `zowe config list --locations --name-only`

### zowe › config › profiles

Displays profile paths.

#### Usage

zowe config profiles [options]

#### Examples

- Display profile paths:

  - `zowe config profiles`

### zowe › config › report-env

Reports key items from your environment and identifies problem conditions.

#### Usage

zowe config report-env [options]

#### Examples

- Report information and issues about your working environment:

  - `zowe config report-env`

- Save the report about your working environment to a file:

  - `zowe config report-env > report.log`

### zowe › config › schema

Dumps the JSON schema for the config. The schema is dynamically created based on your available plugins. Direct the output of this command to a file and include in your config with '$schema' property to get editor completion.

#### Usage

zowe config schema [options]

#### Examples

- Display the JSON schema for the config:

  - `zowe config schema`

### zowe › config › secure

Prompt for secure configuration properties.

#### Usage

zowe config secure [options]

#### Options

- `--global-config` | `--gc` (boolean)

  - Secure properties in global config.

    Default value: false

- `--user-config` | `--uc` (boolean)

  - Secure properties in user config.

    Default value: false

- `--prune` | `-p` (boolean)

  - Delete properties stored in the vault for Zowe client config files that do not exist.

    Default value: false

- `--profile` | `--pf` (string)

  - Specify the profile for which you want to configure secure values.

#### Examples

- Secure the properties in global config:

  - `zowe config secure --global-config`

- Secure the properties in user config:

  - `zowe config secure --user-config`

### zowe › config › set

Create or update a configuration property.

#### Usage

zowe config set <property> [value] [options]

#### Positional Arguments

- `property` (string)

  - The property to set. You may specify a path using dot notation (e.g. profiles.host1.profiles.service1.properties.setting).

- `value` (string)

  - The property value to set. The value may be JSON. Use '--json' to indicate.

#### Options

- `--global-config` | `--gc` (boolean)

  - Set the property in global config.

    Default value: false

- `--user-config` | `--uc` (boolean)

  - Set the property in user config.

    Default value: false

- `--json` (boolean)

  - The property value is JSON.

    Default value: false

- `--secure` (boolean)

  - Store the property value securely. If omitted, any property named in the secure array of the config file will be saved securely.

#### Examples

- Set the property in global config:

  - `zowe config set "profiles.host1.profiles.service1.properties.setting" "value" --global-config`

- Set the property in user config:

  - `zowe config set "profiles.host1.profiles.service2.properties.setting" "value" --user-config`

- Set property value to JSON:

  - `zowe config set "profiles.host1.profiles.service3.properties.setting" "{"property":"value"}" --json`

- Store the property value:

  - `zowe config set "profiles.host1.profiles.service1.properties.setting" "value" --secure`

- Set a default zosmf profile:

  - `zowe config set "defaults.zosmf" "zosmfProfileName"`

- Set a default tso profile:

  - `zowe config set "defaults.tso" "tsoProfileName"`

### zowe › config › update-schemas

Update schema files by looking up the directory structure.

Schema files up in higher level directories will always be updated. To also update schema files down in lower level directories, specify the `--depth` flag.

#### Usage

zowe config update-schemas [options]

#### Options

- `--depth` (number)

  - Specifies how many levels down the directory structure should the schemas be updated.

    Default value: 0

#### Examples

- Update all schema files found in higher level directories:

  - `zowe config update-schemas`

- Update all schema files found in higher level directories and 2 levels down the directory structure:

  - `zowe config update-schemas --depth 2`

## zowe › daemon

Perform operations that control the daemon-mode functionality of the Zowe CLI. Daemon-mode runs the CLI command processor as a daemon to improve performance.

### zowe › daemon › disable

Disable daemon-mode operation of the Zowe CLI.

#### Usage

zowe daemon disable [options]

#### Examples

- Disable daemon-mode:

  - `zowe daemon disable`

### zowe › daemon › enable

Enable daemon-mode operation of the Zowe CLI. You only need to run the enable command once after each new installation of the Zowe CLI. Afterwards, any zowe command will automatically start a daemon as needed.

#### Usage

zowe daemon enable [options]

#### Examples

- Enable daemon-mode:

  - `zowe daemon enable`

### zowe › daemon › restart

Restart the Zowe CLI daemon.

#### Usage

zowe daemon restart [options]

#### Examples

- Restart daemon:

  - `zowe daemon restart`

## zowe › db2

Interact with IBM Db2 for z/OS

## zowe › db2 › call

Call a Db2 stored procedure

### zowe › db2 › call › procedure

Call a Db2 stored procedure. Specify the stored procedure name and optionally provide values.

#### Usage

zowe db2 call procedure <routine> [options]

#### Positional Arguments

- `routine` (string)

  - The name of a Db2 stored procedure

#### Options

- `--parameters` | `-p` (array)

  - Values to bind to the stored procedure parameters

#### DB2 Connection Options

- `--host` | `-H` (string)

  - The Db2 server host name

- `--port` | `-P` (number)

  - The Db2 server port number

- `--user` | `-u` (string)

  - The Db2 user ID (may be the same as the TSO login)

- `--password` | `--pass` | `--pw` (string)

  - The Db2 password (may be the same as the TSO password)

- `--database` | `--db` (string)

  - The name of the database

- `--sslFile` | `--ssl` (string)

  - Path to an SSL Certificate file

#### Profile Options

- `--db2-profile` | `--db2-p` (string)

  - The name of a (db2) 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

- `--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

- Call stored procedure DEMO.SP1:

  - `zowe db2 call procedure "DEMO.SP1"`

- Call a stored procedure and pass values for parameter indicators:

  - `zowe db2 call procedure "DEMO.SP2(?, ?)" --parameters "Hello" "world!"`

- Call a stored procedure and pass values for two output parameters. The first output requires a 2-character buffer. The second output is a message that will be truncated to the length of the placeholder.:

  - `zowe db2 call procedure "DEMO.SP3(NULL, ?, ?)" --parameters "00" "message_placeholder_message_placeholder"`

## zowe › db2 › execute

Execute SQL queries against a Db2 region and retrieve the response. Enclose the query in quotes and escape any symbols that have a special meaning to the shell.

### zowe › db2 › execute › sql

Execute one or multiple SQL statements separated by a semicolon from a command line or from a file.

#### Usage

zowe db2 execute sql [options]

#### Options

- `--query` | `-q` (string)

  - The SQL statement verbatim to execute

- `--file` | `-f` (string)

  - A local file containing the SQL statements to execute

#### DB2 Connection Options

- `--host` | `-H` (string)

  - The Db2 server host name

- `--port` | `-P` (number)

  - The Db2 server port number

- `--user` | `-u` (string)

  - The Db2 user ID (may be the same as the TSO login)

- `--password` | `--pass` | `--pw` (string)

  - The Db2 password (may be the same as the TSO password)

- `--database` | `--db` (string)

  - The name of the database

- `--sslFile` | `--ssl` (string)

  - Path to an SSL Certificate file

#### Profile Options

- `--db2-profile` | `--db2-p` (string)

  - The name of a (db2) 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

- `--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

- Execute a dummy SQL query:

  - `zowe db2 execute sql --query "SELECT 'Hello World' FROM SYSIBM.SYSDUMMY1"`

- Retrieve the employees table and total number of rows:

  - `zowe db2 execute sql -q "SELECT * FROM SAMPLE.EMP; SELECT COUNT(*) AS TOTAL FROM SAMPLE.EMP"`

- Execute a file with SQL statements:

  - `zowe db2 execute sql --file backup_sample_database.sql`

## zowe › db2 › export

Export data from a Db2 table

### zowe › db2 › export › table

Export a Db2 table to the stdout or a file.

#### Usage

zowe db2 export table <table> [options]

#### Positional Arguments

- `table` (string)

  - The name of the table to export

#### Options

- `--outfile` | `-o` (string)

  - The path to the output file

- `--separator` | `--sep` (string)

  - Specify whether to add a separator between statements when exporting a table

#### DB2 Connection Options

- `--host` | `-H` (string)

  - The Db2 server host name

- `--port` | `-P` (number)

  - The Db2 server port number

- `--user` | `-u` (string)

  - The Db2 user ID (may be the same as the TSO login)

- `--password` | `--pass` | `--pw` (string)

  - The Db2 password (may be the same as the TSO password)

- `--database` | `--db` (string)

  - The name of the database

- `--sslFile` | `--ssl` (string)

  - Path to an SSL Certificate file

#### Profile Options

- `--db2-profile` | `--db2-p` (string)

  - The name of a (db2) 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

- `--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

- Export employees data from the table SAMPLE.EMP and save it to the file 'employees.sql':

  - `zowe db2 export table SAMPLE.EMP --outfile employees.sql`

## zowe › dbm-db2

DBM-Db2 plug-in to interact with Db2 using the Broadcom Database Management Solutions for Db2 for z/OS.

For details about command usage for automation, see DBM-Db2 samples at https://github.com/BroadcomMFD/dbm-db2-for-zowe-cli

## zowe › dbm-db2 › check

Perform DDL syntax checking.

### zowe › dbm-db2 › check › ddl

Validate the syntax of input DDL and optionally verify Db2 object dependencies. Use this command to ensure that the syntax of the input DDL is valid. You can also optionally verify that the objects to be created do not exist on the Db2 subsystem and that the related objects that are required for successful creation of the objects exist on the Db2 subsystem or in the input DDL. You can generate input DDL using the 'zowe dbm generate ddl' command.

For details about command usage for automation, see DBM-Db2 samples at https://github.com/BroadcomMFD/dbm-db2-for-zowe-cli

#### Usage

zowe dbm-db2 check ddl <local-input-ddl-filename> [options]

#### Positional Arguments

- `local-input-ddl-filename` (string)

  - Specifies the local input file that contains the DDL statements for the Db2 objects that you want to validate on a target subsystem. Typically, this file is created by a 'zowe dbm generate ddl' command or retrieved from an archive. You can edit this file.

#### Required Options

- `--target-db2` | `--td` (string)

  - Specifies the target Db2 subsystem or data sharing group where you want to use a command.

    Note: If you specify the data sharing group, the first active Db2 subsystem in the group is used.

#### Options

- `--verify` | `-v` (string)

  - Specifies whether to verify that the objects to be created do not exist on the Db2 subsystem and that the related objects that are required for successful creation of the objects exist on the Db2 subsystem or in the input DDL.

    Default value: no

    Allowed values: yes, no

- `--error-file` | `--ef` (string)

  - Specifies the local output error file in YAML format. The file contains basic execution information, connection details, dbm-db2 profile parameters, used arguments, and errors that occurred during execution of the command.

    Default value: error.log

- `--modification` | `-m` (string)

  - Specifies a named set of server-managed default parameter values that control the execution behavior of the zowe dbm-db2 commands. For example, you can use a modification to identify a set of default values that differ from the current set of default values.

    For more information about using the modification option, see the DBM Data Service documentation at https://techdocs.broadcom.com/db2mgmt

#### Profile Options

- `--dbm-db2-options-profile` | `--dbm-db2-options-p` (string)

  - The name of a (dbm-db2-options) profile to load for this command execution.

- `--dbm-db2-profile` | `--dbm-db2-p` (string)

  - The name of a (dbm-db2) profile to load for this command execution.

- `--base-profile` | `--base-p` (string)

  - The name of a (base) profile to load for this command execution.

#### DBM-Db2 Connection Options

- `--protocol` (string)

  - Specifies the communication protocol between zowe dbm-db2 client and DBM Data Service.

    Allowed values: http, https

- `--environment-list` | `--el` (string)

  - Specifies a string of one or more entries consisting of a Db2 subsystem ID and a DBM Data Service REST API server host name or TCP/IP address. Use a comma to separate entries. The same Db2 subsystem can be used in multiple DBM Data Service environments. For more information about configuring the DBM Data Service, see the Database Management Solutions for Db2 for z/OS documentation at https://techdocs.broadcom.com/db2mgmt

- `--job-cards` | `--jc` (array)

  - Specifies a string array of z/OS JCL JOB statements.

- `--work-dataset-prefix` | `--wdp` (string)

  - Specifies the prefix (high-level qualifier) in z/OS work data set names.

- `--delete-work-datasets` | `--dwd` (boolean)

  - Specifies whether to delete work data sets on a mainframe after the request is fulfilled.

- `--overwrite-output-files` | `--oof` (boolean)

  - Specifies whether to overwrite output files if they exist.

- `--authid` | `-a` (string)

  - Specifies the primary Db2 authorization ID that is used to establish a connection between Db2 and a process.

- `--sqlid` | `-s` (string)

  - Specifies the authorization ID that is used in generated SET CURRENT SQLID statements.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all DBM DS resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### 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

- Validate DDL statement syntax of the DDL statements in the sample.sql file on the 'TEST' Db2 subsystem:

  - `zowe dbm-db2 check ddl sample.sql --target-db2 TEST`

- Validate DDL statement syntax and verify object dependencies:

  - `zowe dbm-db2 check ddl sample.sql --target-db2 TEST --verify yes`

## zowe › dbm-db2 › compare

Compare DDL with a Db2 subsystem and produce an update script to implement changes.

### zowe › dbm-db2 › compare › ddl

Compare objects that are defined in a DDL file to objects that are defined on a Db2 subsystem and generate an update script to implement the necessary object changes. This command also generates a high-level change summary report and a parseable impact analysis report. You can execute the script that is generated from this command using the 'zowe dbm execute compare-script' command.

For details about command usage for automation, see DBM-Db2 samples at https://github.com/BroadcomMFD/dbm-db2-for-zowe-cli

#### Usage

zowe dbm-db2 compare ddl <local-input-ddl-filename> [options]

#### Positional Arguments

- `local-input-ddl-filename` (string)

  - Specifies the local input file that contains DDL statements for the Db2 objects that you want to compare to Db2 objects on a target subsystem. Typically, this file is created by a 'zowe dbm generate ddl' command or retrieved from an archive. You can edit this file.

#### Required Options

- `--target-db2` | `--td` (string)

  - Specifies the target Db2 subsystem or data sharing group where you want to use a command.

    Note: If you specify the data sharing group, the first active Db2 subsystem in the group is used.

#### Options

- `--match-set` | `--ms` (string)

  - Specifies the creator and name of an existing RC/Migrator automapping mask set. Matching is used to pair objects in a DDL file to objects that are defined on a Db2 subsystem. Matching determines whether the 'change-set' or 'rule-set' options are applied.

    Format:

    <match-set-creator.match-set-name>

    For more information about mask services, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

    Note: If --match-set and --match-set-file are both specified, specifications in match-set-file take precedence.

- `--match-set-file` | `--msf` (string)

  - Specifies the name of the local input file that contains the mapping mask specifications. Matching is used to pair objects in a DDL file to objects that are defined on a Db2 subsystem. For example, a mask specification can account for different schema naming patterns across environments. Matching determines whether the 'change-set' or 'rule-set' options are applied.

    Format:

    <object-type> <source-name-mask> <target-name-mask>;

    STOGROUP <name> <name>
    DATABASE <name> <name>
    TABLESPACE <database.name> <database.name>
    TABLE <schema.name> <schema.name>
    INDEX <schema.name> <schema.name>
    VIEW <schema.name> <schema.name>
    SYNONYM <schema.name> <schema.name>
    ALIAS <schema.name> <schema.name>
    TRIGGER <schema.name> <schema.name>
    SEQUENCE <schema.name> <schema.name>
    FUNCTION <schema.name[.version]> <schema.name[.version]>
    PROCEDURE <schema.name[.version]> <schema.name[.version]>

    Note:
    - <name> must be between 1 and 128 characters. For DATABASE and TABLESPACE, <name> must be between 1 and 8 characters.
    - <schema> must be between 1 and 128 characters.
    - <version> must be between 1 and 64 characters.

    A mask specification can include the following wildcard characters:

    Percent sign (%) indicates that zero or more characters can occupy that position and all remaining positions to the end of the name, or to the next character. The percent sign can be used anywhere in the name. However, the source and target characters must match exactly.

    Hyphen or dash (-) indicates that any character can occupy that position, but a character must exist at that position, and the source and target character must match exactly. The hyphen can be repeated in several places in the name.

    Asterisk (*) indicates matching values. An asterisk cannot be used with other characters.

    Use a semicolon to separate mask specifications. Multiple mask specifications for the same object type are supported.

    Example:

    The following example demonstrates different ways of matching the table MYNAME.MYTABLE to the table YOURNAME.YOURTABLE:

    TABLE MY%.%TABLE YOUR%.%TABLE;
    TABLE MYN-M-.MYT% YOURN-M-.YOURT%;
    TABLE MYNAME.MYTABLE YOURNAME.YOURTABLE;
    TABLE *.MYTABLE *.YOURTABLE;

    For a list of mask specifications, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

    Note:
    - If --match-set and --match-set-file are both specified, specifications in match-set-file take precedence.
    - The matchSetValues options-profile option has the same behavior as the match-set-file command option.

- `--change-set` | `--cs` (string)

  - Specifies the creator and name of an existing RC/Migrator global change set that changes Db2 objects during a command execution.

    Format:

    <change-set-creator.change-set-name>

    For more information about global change services, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

    Note: If change-set and change-set-file are both specified, specifications in change-set-file take precedence.

- `--change-set-file` | `--csf` (string)

  - Specifies the name of the local input file that contains the global change specifications that modify attributes of Db2 objects. Depending on the backend configuration, the changes apply to either ALL objects in the DDL or to NEW objects only as determined by match-set processing.

    Format:

    <object-attribute> <from-value> <to-value>

    The <object-attribute> consists of four characters. The first two characters identify the object type. The last two characters identify the specific attribute. Wildcard characters are supported in <from-value> and <to-value>. If the same <object-attribute> is specified multiple times, the first occurrence takes precedence.

    Example:

    The following example demonstrates changes to the table schema (creator) and tablespace names:

    TBCR TEST% PROD%
    TBTS TESTTS% PRODTS%

    For more information about global change services, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

    Note:
    - If change-set and change-set-file are both specified, specifications in change-set-file take precedence.
    - The changeSetValues options-profile option has the same behavior as the change-set-file command option.

- `--rule-set` | `--rs` (string)

  - Specifies the creator and name of an existing RC/Migrator rule set that overrides Db2 object attributes in the target Db2 subsystem with the corresponding values from the input DDL file. The changes only apply to existing objects, as determined by match-set processing.

    Format:

    <rule-set-creator.rule-set-name>

    For more information about rule database services, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

- `--id` (string)

  - Specifies the 1- to 8-character name of the RC/Migrator compare strategy that is created on the target Db2 subsystem during a command execution.

    Format: The name must begin with a non-numeric character and contain the following characters only: uppercase letters from A to Z, numbers from 0 to 9, and special characters $, #, and @.

- `--description` | `-d` (string)

  - Specifies a 1- to 25-character description for the RC/Migrator compare strategy.

- `--output-compare-script` | `--ocs` (string)

  - Specifies the name of the local output file that contains the update script to make changes to objects that reside on the Db2 subsystem.

    Default value: compare.txt

- `--output-summary-file` | `--osf` (string)

  - Specifies the name of the local output file that contains the change summary report in text format. This report tracks changes to Db2 objects on the target Db2 subsystem, but it does not describe how changes are made.

    Default value: summary.txt

- `--output-impact-file` | `--oif` (string)

  - Specifies the name of the local output file that contains the parseable impact analysis report in JSON or YAML format. This report identifies the significant DDL operations that are performed on Db2 objects. The report provides the total number and type of DDL operations that are performed on each object type, the list of DDL operations performed on each object instance, and the state of any pending changes.

    To determine the report format, supply one of the following extensions in the file name:
    - .json for JSON
    - .yaml or .yml for YAML
    If no extension is provided, the format is set to JSON.

    Default value: impact.json

    For more information about the impact analysis report, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

- `--error-file` | `--ef` (string)

  - Specifies the local output error file in YAML format. The file contains basic execution information, connection details, dbm-db2 profile parameters, used arguments, and errors that occurred during execution of the command.

    Default value: error.log

- `--modification` | `-m` (string)

  - Specifies a named set of server-managed default parameter values that control the execution behavior of the zowe dbm-db2 commands. For example, you can use a modification to identify a set of default values that differ from the current set of default values.

    For more information about using the modification option, see the DBM Data Service documentation at https://techdocs.broadcom.com/db2mgmt

#### Profile Options

- `--dbm-db2-options-profile` | `--dbm-db2-options-p` (string)

  - The name of a (dbm-db2-options) profile to load for this command execution.

- `--dbm-db2-profile` | `--dbm-db2-p` (string)

  - The name of a (dbm-db2) profile to load for this command execution.

- `--base-profile` | `--base-p` (string)

  - The name of a (base) profile to load for this command execution.

#### DBM-Db2 Connection Options

- `--protocol` (string)

  - Specifies the communication protocol between zowe dbm-db2 client and DBM Data Service.

    Allowed values: http, https

- `--environment-list` | `--el` (string)

  - Specifies a string of one or more entries consisting of a Db2 subsystem ID and a DBM Data Service REST API server host name or TCP/IP address. Use a comma to separate entries. The same Db2 subsystem can be used in multiple DBM Data Service environments. For more information about configuring the DBM Data Service, see the Database Management Solutions for Db2 for z/OS documentation at https://techdocs.broadcom.com/db2mgmt

- `--job-cards` | `--jc` (array)

  - Specifies a string array of z/OS JCL JOB statements.

- `--work-dataset-prefix` | `--wdp` (string)

  - Specifies the prefix (high-level qualifier) in z/OS work data set names.

- `--delete-work-datasets` | `--dwd` (boolean)

  - Specifies whether to delete work data sets on a mainframe after the request is fulfilled.

- `--overwrite-output-files` | `--oof` (boolean)

  - Specifies whether to overwrite output files if they exist.

- `--authid` | `-a` (string)

  - Specifies the primary Db2 authorization ID that is used to establish a connection between Db2 and a process.

- `--sqlid` | `-s` (string)

  - Specifies the authorization ID that is used in generated SET CURRENT SQLID statements.

- `--termination-character` | `--tc` (string)

  - Specifies the SQL termination character to use in DDL generation when the default termination character conflicts with the SQL statements that are used in triggers, XML indexes, and routines (external SQL functions and native SQL stored procedures). The default termination character is a semi-colon (;). You cannot specify a comma, double quote, single quote, left or right parentheses, or an underscore.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all DBM DS resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### 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

- Generate a script to update objects on the 'TEST' Db2 subsystem with DDL definitions in myddl.sql file:

  - `zowe dbm-db2 compare ddl myddl.sql --target-db2 TEST`

- Generate a script to update objects and apply a rule set for the matched objects:

  - `zowe dbm-db2 compare ddl myddl.sql --target-db2 TEST --rule-set USER1.RULESET`

- Generate a script to update objects and apply a rule set for the objects matched as determined by the local mask specifications in the pair.txt file:

  - `zowe dbm-db2 compare ddl myddl.sql --target-db2 TEST --rule-set USER1.RULESET --match-set-file pair.txt`

## zowe › dbm-db2 › deploy

Deploy DDL statements to a Db2 subsystem.

### zowe › dbm-db2 › deploy › ddl

Deploy Db2 object changes on the target Db2 subsystem using an input file that contains the DDL. For example, an application developer has made changes to DDL in a local file and is ready to test the DDL changes. Use this command to deploy the changes to the test environment.

For details about command usage for automation, see DBM-Db2 samples at https://github.com/BroadcomMFD/dbm-db2-for-zowe-cli

#### Usage

zowe dbm-db2 deploy ddl <local-input-ddl-filename> [options]

#### Positional Arguments

- `local-input-ddl-filename` (string)

  - Specifies the local input file that contains DDL statements for the Db2 objects that you want to deploy on a target subsystem. Typically, this file is created by a 'zowe dbm generate ddl' command or retrieved from an archive. You can edit this file.

#### Required Options

- `--target-db2` | `--td` (string)

  - Specifies the target Db2 subsystem or data sharing group where you want to use a command.

    Note: If you specify the data sharing group, the first active Db2 subsystem in the group is used.

#### Options

- `--match-set` | `--ms` (string)

  - Specifies the creator and name of an existing RC/Migrator automapping mask set. Matching is used to pair objects in a DDL file to objects that are defined on a Db2 subsystem. Matching determines whether the 'change-set' or 'rule-set' options are applied.

    Format:

    <match-set-creator.match-set-name>

    For more information about mask services, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

    Note: If --match-set and --match-set-file are both specified, specifications in match-set-file take precedence.

- `--match-set-file` | `--msf` (string)

  - Specifies the name of the local input file that contains the mapping mask specifications. Matching is used to pair objects in a DDL file to objects that are defined on a Db2 subsystem. For example, a mask specification can account for different schema naming patterns across environments. Matching determines whether the 'change-set' or 'rule-set' options are applied.

    Format:

    <object-type> <source-name-mask> <target-name-mask>;

    STOGROUP <name> <name>
    DATABASE <name> <name>
    TABLESPACE <database.name> <database.name>
    TABLE <schema.name> <schema.name>
    INDEX <schema.name> <schema.name>
    VIEW <schema.name> <schema.name>
    SYNONYM <schema.name> <schema.name>
    ALIAS <schema.name> <schema.name>
    TRIGGER <schema.name> <schema.name>
    SEQUENCE <schema.name> <schema.name>
    FUNCTION <schema.name[.version]> <schema.name[.version]>
    PROCEDURE <schema.name[.version]> <schema.name[.version]>

    Note:
    - <name> must be between 1 and 128 characters. For DATABASE and TABLESPACE, <name> must be between 1 and 8 characters.
    - <schema> must be between 1 and 128 characters.
    - <version> must be between 1 and 64 characters.

    A mask specification can include the following wildcard characters:

    Percent sign (%) indicates that zero or more characters can occupy that position and all remaining positions to the end of the name, or to the next character. The percent sign can be used anywhere in the name. However, the source and target characters must match exactly.

    Hyphen or dash (-) indicates that any character can occupy that position, but a character must exist at that position, and the source and target character must match exactly. The hyphen can be repeated in several places in the name.

    Asterisk (*) indicates matching values. An asterisk cannot be used with other characters.

    Use a semicolon to separate mask specifications. Multiple mask specifications for the same object type are supported.

    Example:

    The following example demonstrates different ways of matching the table MYNAME.MYTABLE to the table YOURNAME.YOURTABLE:

    TABLE MY%.%TABLE YOUR%.%TABLE;
    TABLE MYN-M-.MYT% YOURN-M-.YOURT%;
    TABLE MYNAME.MYTABLE YOURNAME.YOURTABLE;
    TABLE *.MYTABLE *.YOURTABLE;

    For a list of mask specifications, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

    Note:
    - If --match-set and --match-set-file are both specified, specifications in match-set-file take precedence.
    - The matchSetValues options-profile option has the same behavior as the match-set-file command option.

- `--change-set` | `--cs` (string)

  - Specifies the creator and name of an existing RC/Migrator global change set that changes Db2 objects during a command execution.

    Format:

    <change-set-creator.change-set-name>

    For more information about global change services, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

    Note: If change-set and change-set-file are both specified, specifications in change-set-file take precedence.

- `--change-set-file` | `--csf` (string)

  - Specifies the name of the local input file that contains the global change specifications that modify attributes of Db2 objects. Depending on the backend configuration, the changes apply to either ALL objects in the DDL or to NEW objects only as determined by match-set processing.

    Format:

    <object-attribute> <from-value> <to-value>

    The <object-attribute> consists of four characters. The first two characters identify the object type. The last two characters identify the specific attribute. Wildcard characters are supported in <from-value> and <to-value>. If the same <object-attribute> is specified multiple times, the first occurrence takes precedence.

    Example:

    The following example demonstrates changes to the table schema (creator) and tablespace names:

    TBCR TEST% PROD%
    TBTS TESTTS% PRODTS%

    For more information about global change services, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

    Note:
    - If change-set and change-set-file are both specified, specifications in change-set-file take precedence.
    - The changeSetValues options-profile option has the same behavior as the change-set-file command option.

- `--rule-set` | `--rs` (string)

  - Specifies the creator and name of an existing RC/Migrator rule set that overrides Db2 object attributes in the target Db2 subsystem with the corresponding values from the input DDL file. The changes only apply to existing objects, as determined by match-set processing.

    Format:

    <rule-set-creator.rule-set-name>

    For more information about rule database services, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

- `--error-file` | `--ef` (string)

  - Specifies the local output error file in YAML format. The file contains basic execution information, connection details, dbm-db2 profile parameters, used arguments, and errors that occurred during execution of the command.

    Default value: error.log

- `--modification` | `-m` (string)

  - Specifies a named set of server-managed default parameter values that control the execution behavior of the zowe dbm-db2 commands. For example, you can use a modification to identify a set of default values that differ from the current set of default values.

    For more information about using the modification option, see the DBM Data Service documentation at https://techdocs.broadcom.com/db2mgmt

#### Profile Options

- `--dbm-db2-options-profile` | `--dbm-db2-options-p` (string)

  - The name of a (dbm-db2-options) profile to load for this command execution.

- `--dbm-db2-profile` | `--dbm-db2-p` (string)

  - The name of a (dbm-db2) profile to load for this command execution.

- `--base-profile` | `--base-p` (string)

  - The name of a (base) profile to load for this command execution.

#### DBM-Db2 Connection Options

- `--protocol` (string)

  - Specifies the communication protocol between zowe dbm-db2 client and DBM Data Service.

    Allowed values: http, https

- `--environment-list` | `--el` (string)

  - Specifies a string of one or more entries consisting of a Db2 subsystem ID and a DBM Data Service REST API server host name or TCP/IP address. Use a comma to separate entries. The same Db2 subsystem can be used in multiple DBM Data Service environments. For more information about configuring the DBM Data Service, see the Database Management Solutions for Db2 for z/OS documentation at https://techdocs.broadcom.com/db2mgmt

- `--job-cards` | `--jc` (array)

  - Specifies a string array of z/OS JCL JOB statements.

- `--work-dataset-prefix` | `--wdp` (string)

  - Specifies the prefix (high-level qualifier) in z/OS work data set names.

- `--delete-work-datasets` | `--dwd` (boolean)

  - Specifies whether to delete work data sets on a mainframe after the request is fulfilled.

- `--overwrite-output-files` | `--oof` (boolean)

  - Specifies whether to overwrite output files if they exist.

- `--authid` | `-a` (string)

  - Specifies the primary Db2 authorization ID that is used to establish a connection between Db2 and a process.

- `--sqlid` | `-s` (string)

  - Specifies the authorization ID that is used in generated SET CURRENT SQLID statements.

- `--termination-character` | `--tc` (string)

  - Specifies the SQL termination character to use in DDL generation when the default termination character conflicts with the SQL statements that are used in triggers, XML indexes, and routines (external SQL functions and native SQL stored procedures). The default termination character is a semi-colon (;). You cannot specify a comma, double quote, single quote, left or right parentheses, or an underscore.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all DBM DS resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### 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

- Update Db2 objects on a target Db2 subsystem according to DDL definitions in myddl.sql file:

  - `zowe dbm-db2 deploy ddl myddl.sql --target-db2 TEST`

- Update Db2 objects according to the input DDL definitions and applied rule set for the matched objects:

  - `zowe dbm-db2 deploy ddl myddl.sql --target-db2 TEST --rule-set USER1.RULESET`

- Update Db2 objects according to the input DDL definitions and applied rule set for the objects matched as determined by the local mask specifications in the pair.txt file:

  - `zowe dbm-db2 deploy ddl myddl.sql --target-db2 TEST --rule-set USER1.RULESET --match-set-file pair.txt`

## zowe › dbm-db2 › execute

Execute a script to implement Db2 object changes.

### zowe › dbm-db2 › execute › compare-script

Execute the compare script that was generated with the 'zowe dbm compare ddl' command to implement the Db2 object changes on the Db2 subsystem specified within the script. This command also generates a recovery script to undo compare script changes.

For details about command usage for automation, see DBM-Db2 samples at https://github.com/BroadcomMFD/dbm-db2-for-zowe-cli

#### Usage

zowe dbm-db2 execute compare-script <local-input-compare-script-filename> [options]

#### Positional Arguments

- `local-input-compare-script-filename` (string)

  - Specifies the local input compare-script file that contains the update script that was generated with the 'zowe dbm compare ddl' command.

#### Options

- `--output-recovery-script` | `--ors` | `--output-recovery-file` | `--orf` (string)

  - Specifies the local output file name that contains the recovery script that is generated during execution of this command. Executing the recovery script using the 'zowe dbm execute script' command undoes the changes that were made by execution of the compare-script.

    Default value: recovery.txt

- `--restart` | `-r` (string)

  - Specifies the location in the script where you want to restart execution. The effects of previous successful script statement executions remain.

    The following restart options are valid:

    new - Restart execution of the script at the first statement.

    token - Restart execution of the script at the location that is recorded in the specified token and that was returned from a previous execution failure.

- `--error-file` | `--ef` (string)

  - Specifies the local output error file in YAML format. The file contains basic execution information, connection details, dbm-db2 profile parameters, used arguments, and errors that occurred during execution of the command.

    Default value: error.log

- `--modification` | `-m` (string)

  - Specifies a named set of server-managed default parameter values that control the execution behavior of the zowe dbm-db2 commands. For example, you can use a modification to identify a set of default values that differ from the current set of default values.

    For more information about using the modification option, see the DBM Data Service documentation at https://techdocs.broadcom.com/db2mgmt

#### Profile Options

- `--dbm-db2-options-profile` | `--dbm-db2-options-p` (string)

  - The name of a (dbm-db2-options) profile to load for this command execution.

- `--dbm-db2-profile` | `--dbm-db2-p` (string)

  - The name of a (dbm-db2) profile to load for this command execution.

- `--base-profile` | `--base-p` (string)

  - The name of a (base) profile to load for this command execution.

#### DBM-Db2 Connection Options

- `--protocol` (string)

  - Specifies the communication protocol between zowe dbm-db2 client and DBM Data Service.

    Allowed values: http, https

- `--environment-list` | `--el` (string)

  - Specifies a string of one or more entries consisting of a Db2 subsystem ID and a DBM Data Service REST API server host name or TCP/IP address. Use a comma to separate entries. The same Db2 subsystem can be used in multiple DBM Data Service environments. For more information about configuring the DBM Data Service, see the Database Management Solutions for Db2 for z/OS documentation at https://techdocs.broadcom.com/db2mgmt

- `--job-cards` | `--jc` (array)

  - Specifies a string array of z/OS JCL JOB statements.

- `--work-dataset-prefix` | `--wdp` (string)

  - Specifies the prefix (high-level qualifier) in z/OS work data set names.

- `--delete-work-datasets` | `--dwd` (boolean)

  - Specifies whether to delete work data sets on a mainframe after the request is fulfilled.

- `--overwrite-output-files` | `--oof` (boolean)

  - Specifies whether to overwrite output files if they exist.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all DBM DS resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### 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

- Execute a compare script:

  - `zowe dbm-db2 execute compare-script compare.txt`

- Restart execution of a compare script at the first statement in the script:

  - `zowe dbm-db2 execute compare-script compare.txt --restart new`

- Restart execution of a compare script at the location in the token:

  - `zowe dbm-db2 execute compare-script compare.txt --restart 78A724GOBLEDYGOOK6FD140F6780D6FA`

### zowe › dbm-db2 › execute › migration-script

Execute the migration script that was generated with the 'zowe dbm prepare migration' command to migrate Db2 objects (DDL) and table data from a source subsystem to a target subsystem. The source and target subsystem IDs are specified within the script.

For details about command usage for automation, see DBM-Db2 samples at https://github.com/BroadcomMFD/dbm-db2-for-zowe-cli

#### Usage

zowe dbm-db2 execute migration-script <local-input-migrate-script-filename> [options]

#### Positional Arguments

- `local-input-migrate-script-filename` (string)

  - Specifies the local input migration-script file that was generated with the 'zowe dbm prepare migration' command.

#### Options

- `--restart` | `-r` (string)

  - Specifies the location in the script where you want to restart execution. The effects of previous successful script statement executions remain.

    The following restart options are valid:

    new - Restart execution of the script at the first statement.

    name, token - Restart execution of the script at the location in the restart section that is recorded in the specified token and that was returned from a prior execution failure.

    A section is a '.SYSTEM <name>' statement, where <name> identifies a logical grouping of statements such as UNLOADS or SQLDDL. 'source' is an alias for UNLOADS. 'target' is an alias for SQLDDL.

- `--error-file` | `--ef` (string)

  - Specifies the local output error file in YAML format. The file contains basic execution information, connection details, dbm-db2 profile parameters, used arguments, and errors that occurred during execution of the command.

    Default value: error.log

- `--modification` | `-m` (string)

  - Specifies a named set of server-managed default parameter values that control the execution behavior of the zowe dbm-db2 commands. For example, you can use a modification to identify a set of default values that differ from the current set of default values.

    For more information about using the modification option, see the DBM Data Service documentation at https://techdocs.broadcom.com/db2mgmt

#### Profile Options

- `--dbm-db2-options-profile` | `--dbm-db2-options-p` (string)

  - The name of a (dbm-db2-options) profile to load for this command execution.

- `--dbm-db2-profile` | `--dbm-db2-p` (string)

  - The name of a (dbm-db2) profile to load for this command execution.

- `--base-profile` | `--base-p` (string)

  - The name of a (base) profile to load for this command execution.

#### DBM-Db2 Connection Options

- `--protocol` (string)

  - Specifies the communication protocol between zowe dbm-db2 client and DBM Data Service.

    Allowed values: http, https

- `--environment-list` | `--el` (string)

  - Specifies a string of one or more entries consisting of a Db2 subsystem ID and a DBM Data Service REST API server host name or TCP/IP address. Use a comma to separate entries. The same Db2 subsystem can be used in multiple DBM Data Service environments. For more information about configuring the DBM Data Service, see the Database Management Solutions for Db2 for z/OS documentation at https://techdocs.broadcom.com/db2mgmt

- `--job-cards` | `--jc` (array)

  - Specifies a string array of z/OS JCL JOB statements.

- `--work-dataset-prefix` | `--wdp` (string)

  - Specifies the prefix (high-level qualifier) in z/OS work data set names.

- `--delete-work-datasets` | `--dwd` (boolean)

  - Specifies whether to delete work data sets on a mainframe after the request is fulfilled.

- `--overwrite-output-files` | `--oof` (boolean)

  - Specifies whether to overwrite output files if they exist.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all DBM DS resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### 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

- Execute a migration script:

  - `zowe dbm-db2 execute migration-script migration.txt`

- Restart execution of a migration script at the first statement in the script:

  - `zowe dbm-db2 execute migration-script migration.txt --restart new`

- Restart execution of a migration script at the location in the token. Execution begins at the last successful sync point that is recorded in the restart token up to the end of the restart token section:

  - `zowe dbm-db2 execute migration-script migration.txt --restart target,78A724GOBLEDYGOOK6FD140F6780D6FA`

### zowe › dbm-db2 › execute › script

Execute a Batch Processor script on a target subsystem. For example, use this command to execute a Batch Processor script or specifically to execute a recovery script to undo changes that were made by the 'zowe dbm execute compare-script' command. If execution of the script fails, you can execute it again using the 'script-section' or 'restart' options. You can edit the script and make changes before you execute or restart it.

For details about command usage for automation, see DBM-Db2 samples at https://github.com/BroadcomMFD/dbm-db2-for-zowe-cli

#### Usage

zowe dbm-db2 execute script <local-input-bp-script-filename> [options]

#### Positional Arguments

- `local-input-bp-script-filename` (string)

  - Specifies the local input file that contains the Batch Processor statements such as the recovery script that was created by executing the 'zowe dbm execute compare-script' command.

#### Options

- `--target-db2` | `--td` (string)

  - Specifies the target Db2 subsystem or data sharing group where you want to execute the script. If this option is not specified, the target subsystem is identified by the first .CONNECT statement in the script.

    Note: If you specify the data sharing group, the first active Db2 subsystem in the group is used.

    The target-db2 option takes precedence over any other value that is specified for the Db2 subsystem or data sharing group.

- `--script-section` | `--ss` (string)

  - Identifies the location in the script where you want to begin execution.

    The following options are valid:

    name - Begin execution of the specific section and process all subsequent statements up to the next section.

    A section is a '.SYSTEM <name>' statement, where <name> identifies a logical grouping of statements such as UNLOADS or SQLDDL. 'source' is an alias for UNLOADS. 'target' is an alias for SQLDDL.

    number - Begin execution after the specific sync point (.SYNC <number> statement) and process all statements up to the end of the script.

    name, number - Begin execution of the specific script section beginning from the sync point (.SYNC <number> statement) within the section and process all subsequent statements up to the next section.

- `--restart` | `-r` (string)

  - Specifies the location in the script where you want to restart execution. The effects of previous successful script statement executions remain.

    The following restart options are valid:

    new - Restart execution of the script at the first statement.

    token - Restart execution of the script at the location that is recorded in the specified token and that was returned from a previous execution failure.

    name, token - Restart execution of the script at the location in the restart section that is recorded in the specified token and that was returned from a prior execution failure.

    A section is a Batch Processor '.SYSTEM <name>' statement, where <name> identifies a logical grouping of statements such as UNLOADS or SQLDDL. 'source' is an alias for UNLOADS. 'target' is an alias for SQLDDL.

- `--error-file` | `--ef` (string)

  - Specifies the local output error file in YAML format. The file contains basic execution information, connection details, dbm-db2 profile parameters, used arguments, and errors that occurred during execution of the command.

    Default value: error.log

- `--modification` | `-m` (string)

  - Specifies a named set of server-managed default parameter values that control the execution behavior of the zowe dbm-db2 commands. For example, you can use a modification to identify a set of default values that differ from the current set of default values.

    For more information about using the modification option, see the DBM Data Service documentation at https://techdocs.broadcom.com/db2mgmt

#### Profile Options

- `--dbm-db2-options-profile` | `--dbm-db2-options-p` (string)

  - The name of a (dbm-db2-options) profile to load for this command execution.

- `--dbm-db2-profile` | `--dbm-db2-p` (string)

  - The name of a (dbm-db2) profile to load for this command execution.

- `--base-profile` | `--base-p` (string)

  - The name of a (base) profile to load for this command execution.

#### DBM-Db2 Connection Options

- `--protocol` (string)

  - Specifies the communication protocol between zowe dbm-db2 client and DBM Data Service.

    Allowed values: http, https

- `--environment-list` | `--el` (string)

  - Specifies a string of one or more entries consisting of a Db2 subsystem ID and a DBM Data Service REST API server host name or TCP/IP address. Use a comma to separate entries. The same Db2 subsystem can be used in multiple DBM Data Service environments. For more information about configuring the DBM Data Service, see the Database Management Solutions for Db2 for z/OS documentation at https://techdocs.broadcom.com/db2mgmt

- `--job-cards` | `--jc` (array)

  - Specifies a string array of z/OS JCL JOB statements.

- `--work-dataset-prefix` | `--wdp` (string)

  - Specifies the prefix (high-level qualifier) in z/OS work data set names.

- `--delete-work-datasets` | `--dwd` (boolean)

  - Specifies whether to delete work data sets on a mainframe after the request is fulfilled.

- `--overwrite-output-files` | `--oof` (boolean)

  - Specifies whether to overwrite output files if they exist.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all DBM DS resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### 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

- Execute a recovery script:

  - `zowe dbm-db2 execute script recovery.txt`

- Execute a script on the 'TEST' Db2 subsystem:

  - `zowe dbm-db2 execute script script001.txt --target-db2 TEST`

- Execute only the SQLDDL section of a script. The first .CONNECT statement in the script identifies the target subsystem where the script is executed. Execution begins at the .SYSTEM SQLDDL statement and ends at the next .SYSTEM statement in the script:

  - `zowe dbm-db2 execute script script001.txt --script-section SQLDDL`

- Execute a script beginning from the sync point 10 (.SYNC 10 statement) to the end of the script:

  - `zowe dbm-db2 execute script script001.txt --script-section 10`

- Execute only the target (SQLDDL) section of the script starting at sync point 20:

  - `zowe dbm-db2 execute script script001.txt --script-section target,20`

- Restart execution of a script from the beginning:

  - `zowe dbm-db2 execute script script001.txt --restart new`

- Restart execution of a script at the location specified in the token. The restart token is returned by a previous 'zowe dbm execute command' failure as part of the terminal output and in the error file:

  - `zowe dbm-db2 execute script script001.txt --restart 78A724A48DA5185D06FD140F6780D6FA`

- Restart execution at the last successful sync point recorded in the restart token up to the end of the target (SQLDDL) section:

  - `zowe dbm-db2 execute script script001.txt --restart target,78A724A48DA5185D06FD140F6780D6FA`

## zowe › dbm-db2 › generate

Generate DDL statements for Db2 objects.

### zowe › dbm-db2 › generate › ddl

Generate CREATE or DROP DDL statements for specified Db2 objects into an output DDL file. For example, use this command to generate CREATE TABLE definitions that you can then edit and use to update the table definition on a Db2 subsystem with the 'zowe dbm compare ddl' command.

For details about command usage for automation, see DBM-Db2 samples at https://github.com/BroadcomMFD/dbm-db2-for-zowe-cli

#### Usage

zowe dbm-db2 generate ddl [options]

#### Required Options

- `--object` | `-o` (string)

  - Specifies the Db2 objects to be generated in DDL. Use the optional include clause to include related Db2 objects.

         Format: see the object\-file description

        Note: The \-\-object and \-\-object\-file options are mutually exclusive.

- `--object-file` | `--of` (string)

  - Specifies the name of the local input file that contains a list of Db2 objects to be generated in DDL. Use a semicolon to separate objects. Use the optional include clause to include related Db2 objects.

    Format:

    <object-type> <object-name> [include(<related-object-type>,...)];

    The required clause <object-type> <object-name> identifies the specific Db2 (base) object:

    STOGROUP <name>
    DATABASE <name>
    TABLESPACE <dbname.name>
    TABLE <schema.name>
    INDEX <schema.name>
    VIEW <schema.name>
    ALIAS <schema.name>
    SYNONYM <schema.name>
    MQT <schema.name>
    SEQUENCE <schema.name>
    TRIGGER <schema.name[.version]>
    FUNCTION <schema.name[.version]>
    PROCEDURE <schema.name[.version]>

    The optional include clause (<related-object-type>,...) identifies one or more related Db2 object types to include in the object list.

    You can specify the following object types: STOGROUP, DATABASE, TABLESPACE, TABLE, INDEX, VIEW, SYNONYM, MQT-ALL, TRIGGER, ROUTINE, PARENTS, CHILDREN, and ALL.

    Example:

    table sysibm.systables include (tablespace, database, index);
    database db1 include(children);

    Note: The --object and --object-file options are mutually exclusive.

- `--source-db2` | `--sd` (string)

  - Specifies the source Db2 subsystem or data sharing group where the objects that you want to use in a command are located.

    Note: If you specify the data sharing group, the first active Db2 subsystem in the group is used.

#### Options

- `--change-set` | `--cs` (string)

  - Specifies the creator and name of an existing RC/Migrator global change set that changes Db2 objects during a command execution.

    Format:

    <change-set-creator.change-set-name>

    For more information about global change services, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

    Note: If change-set and change-set-file are both specified, specifications in change-set-file take precedence.

- `--change-set-file` | `--csf` (string)

  - Specifies the name of the local input file that contains the global change specifications that modify attributes of Db2 objects.

    Format:

    <object-attribute> <from-value> <to-value>

    The <object-attribute> consists of four characters. The first two characters identify the object type. The last two characters identify the specific attribute. Wildcard characters are supported in <from-value> and <to-value>. If the same <object-attribute> is specified multiple times, the first occurrence takes precedence.

    For a full list of attributes, see Global Change Set Attributes in the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

    Example:

    The following example demonstrates changes to the table schema (creator) and tablespace names:

    TBCR TEST% PROD%
    TBTS TESTTS% PRODTS%

    Note:
    - If change-set and change-set-file are both specified, specifications in change-set-file take precedence.
    - The changeSetValues options-profile option has the same behavior as the change-set-file command option.

- `--type` | `-t` (string)

  - Specifies the type of DDL statements that you want to generate. You can generate CREATE or DROP statements.

    Default value: create
    Allowed values: drop, create

- `--output-ddl-file` | `--odf` (string)

  - Specifies the local output file name that contains the generated DDL for the objects that are identified by the --object-file or --object option.

    Default value: output.sql

- `--error-file` | `--ef` (string)

  - Specifies the local output error file in YAML format. The file contains basic execution information, connection details, dbm-db2 profile parameters, used arguments, and errors that occurred during execution of the command.

    Default value: error.log

- `--modification` | `-m` (string)

  - Specifies a named set of server-managed default parameter values that control the execution behavior of the zowe dbm-db2 commands. For example, you can use a modification to identify a set of default values that differ from the current set of default values.

    For more information about using the modification option, see the DBM Data Service documentation at https://techdocs.broadcom.com/db2mgmt

#### Profile Options

- `--dbm-db2-options-profile` | `--dbm-db2-options-p` (string)

  - The name of a (dbm-db2-options) profile to load for this command execution.

- `--dbm-db2-profile` | `--dbm-db2-p` (string)

  - The name of a (dbm-db2) profile to load for this command execution.

- `--base-profile` | `--base-p` (string)

  - The name of a (base) profile to load for this command execution.

#### DBM-Db2 Connection Options

- `--protocol` (string)

  - Specifies the communication protocol between zowe dbm-db2 client and DBM Data Service.

    Allowed values: http, https

- `--environment-list` | `--el` (string)

  - Specifies a string of one or more entries consisting of a Db2 subsystem ID and a DBM Data Service REST API server host name or TCP/IP address. Use a comma to separate entries. The same Db2 subsystem can be used in multiple DBM Data Service environments. For more information about configuring the DBM Data Service, see the Database Management Solutions for Db2 for z/OS documentation at https://techdocs.broadcom.com/db2mgmt

- `--job-cards` | `--jc` (array)

  - Specifies a string array of z/OS JCL JOB statements.

- `--work-dataset-prefix` | `--wdp` (string)

  - Specifies the prefix (high-level qualifier) in z/OS work data set names.

- `--delete-work-datasets` | `--dwd` (boolean)

  - Specifies whether to delete work data sets on a mainframe after the request is fulfilled.

- `--overwrite-output-files` | `--oof` (boolean)

  - Specifies whether to overwrite output files if they exist.

- `--authid` | `-a` (string)

  - Specifies the primary Db2 authorization ID that is used to establish a connection between Db2 and a process.

- `--sqlid` | `-s` (string)

  - Specifies the authorization ID that is used in generated SET CURRENT SQLID statements.

- `--termination-character` | `--tc` (string)

  - Specifies the SQL termination character to use in DDL generation when the default termination character conflicts with the SQL statements that are used in triggers, XML indexes, and routines (external SQL functions and native SQL stored procedures). The default termination character is a semi-colon (;). You cannot specify a comma, double quote, single quote, left or right parentheses, or an underscore.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all DBM DS resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### 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

- Generate CREATE DDL statements for a tablespace and its child table:

  - `zowe dbm-db2 generate ddl --object "tablespace my.tbsp include(table)" --source-db2 SRC --output-ddl-file objects.sql`

- Generate CREATE DDL statements for a database and its children and apply changes as defined in the change set:

  - `zowe dbm-db2 generate ddl --object "database my.db include(children)" --source-db2 SRC --change-set USER1.CHANGSET --output-ddl-file objects.sql`

- Generate DROP DDL statements only for the input object list:

  - `zowe dbm-db2 generate ddl --object-file objects.txt --source-db2 SRC --type drop --output-ddl-file output.sql`

## zowe › dbm-db2 › prepare

Prepare DDL statements and a script to migrate Db2 objects.

### zowe › dbm-db2 › prepare › migration

Generate a script to migrate Db2 object definitions (DDL) and data from a source subsystem to a target subsystem. You can specify which objects to include and apply changes to the objects as part of the migration. To execute the script, use the 'zowe dbm execute migration-script' command.

For details about command usage for automation, see DBM-Db2 samples at https://github.com/BroadcomMFD/dbm-db2-for-zowe-cli

#### Usage

zowe dbm-db2 prepare migration [options]

#### Required Options

- `--object` | `-o` (string)

  - Specifies the Db2 objects to be migrated. Use the optional include clause to include related Db2 objects.

    Format: see the object-file description

    Note: The --object and --object-file options are mutually exclusive.

- `--object-file` | `--of` (string)

  - Specifies the name of the local input file that contains a list of Db2 objects to be migrated. Use a semicolon to separate objects. Use the optional include clause to include related Db2 objects.

    Format:

    <object-type> <object-name> [include(<related-object-type>,...)];

    The required clause <object-type> <object-name> identifies the specific Db2 (base) object:

    STOGROUP <name>
    DATABASE <name>
    TABLESPACE <dbname.name>
    TABLE <schema.name>
    INDEX <schema.name>
    VIEW <schema.name>
    ALIAS <schema.name>
    SYNONYM <schema.name>
    MQT <schema.name>
    SEQUENCE <schema.name>
    TRIGGER <schema.name[.version]>
    FUNCTION <schema.name[.version]>
    PROCEDURE <schema.name[.version]>

    The optional include clause (<related-object-type>,...) identifies one or more related Db2 object types to include in the object list.

    You can specify the following object types: STOGROUP, DATABASE, TABLESPACE, TABLE, INDEX, VIEW, SYNONYM, MQT-ALL, TRIGGER, ROUTINE, PARENTS, CHILDREN, and ALL.

    Example:

    table sysibm.systables include (tablespace, database, index);
    database db1 include(children);

    Note: The --object and --object-file options are mutually exclusive.

- `--source-db2` | `--sd` (string)

  - Specifies the source Db2 subsystem or data sharing group where the objects that you want to use in a command are located.

    Note: If you specify the data sharing group, the first active Db2 subsystem in the group is used.

- `--target-db2` | `--td` (string)

  - Specifies the target Db2 subsystem or data sharing group where you want to use a command.

    Note: If you specify the data sharing group, the first active Db2 subsystem in the group is used.

#### Options

- `--change-set` | `--cs` (string)

  - Specifies the creator and name of an existing RC/Migrator global change set that changes Db2 objects during a command execution.

    Format:

    <change-set-creator.change-set-name>

    For more information about global change services, see the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

    Note: If change-set and change-set-file are both specified, specifications in change-set-file take precedence.

- `--change-set-file` | `--csf` (string)

  - Specifies the name of the local input file that contains the global change specifications that modify attributes of Db2 objects.

    Format:

    <object-attribute> <from-value> <to-value>

    The <object-attribute> consists of four characters. The first two characters identify the object type. The last two characters identify the specific attribute. Wildcard characters are supported in <from-value> and <to-value>. If the same <object-attribute> is specified multiple times, the first occurrence takes precedence.

    For a full list of attributes, see Global Change Set Attributes in the RC/Migrator documentation at https://techdocs.broadcom.com/db2rcmig

    Example:

    The following example demonstrates changes to the table schema (creator) and tablespace names:

    TBCR TEST% PROD%
    TBTS TESTTS% PRODTS%

    Note:
    - If change-set and change-set-file are both specified, specifications in change-set-file take precedence.
    - The changeSetValues options-profile option has the same behavior as the change-set-file command option.

- `--output-migrate-script` | `--oms` (string)

  - Specifies the name of the local output file that contains the script to make changes to objects that reside on the Db2 subsystem.

    Default value: migration.txt

- `--output-ddl-file` | `--odf` (string)

  - Specifies the name of the local output file that contains the generated DDL for objects that are identified by the --object-file or --object option.

    Default value: output.sql

- `--error-file` | `--ef` (string)

  - Specifies the local output error file in YAML format. The file contains basic execution information, connection details, dbm-db2 profile parameters, used arguments, and errors that occurred during execution of the command.

    Default value: error.log

- `--modification` | `-m` (string)

  - Specifies a named set of server-managed default parameter values that control the execution behavior of the zowe dbm-db2 commands. For example, you can use a modification to identify a set of default values that differ from the current set of default values.

    For more information about using the modification option, see the DBM Data Service documentation at https://techdocs.broadcom.com/db2mgmt

#### Profile Options

- `--dbm-db2-options-profile` | `--dbm-db2-options-p` (string)

  - The name of a (dbm-db2-options) profile to load for this command execution.

- `--dbm-db2-profile` | `--dbm-db2-p` (string)

  - The name of a (dbm-db2) profile to load for this command execution.

- `--base-profile` | `--base-p` (string)

  - The name of a (base) profile to load for this command execution.

#### DBM-Db2 Connection Options

- `--protocol` (string)

  - Specifies the communication protocol between zowe dbm-db2 client and DBM Data Service.

    Allowed values: http, https

- `--environment-list` | `--el` (string)

  - Specifies a string of one or more entries consisting of a Db2 subsystem ID and a DBM Data Service REST API server host name or TCP/IP address. Use a comma to separate entries. The same Db2 subsystem can be used in multiple DBM Data Service environments. For more information about configuring the DBM Data Service, see the Database Management Solutions for Db2 for z/OS documentation at https://techdocs.broadcom.com/db2mgmt

- `--job-cards` | `--jc` (array)

  - Specifies a string array of z/OS JCL JOB statements.

- `--work-dataset-prefix` | `--wdp` (string)

  - Specifies the prefix (high-level qualifier) in z/OS work data set names.

- `--delete-work-datasets` | `--dwd` (boolean)

  - Specifies whether to delete work data sets on a mainframe after the request is fulfilled.

- `--overwrite-output-files` | `--oof` (boolean)

  - Specifies whether to overwrite output files if they exist.

- `--authid` | `-a` (string)

  - Specifies the primary Db2 authorization ID that is used to establish a connection between Db2 and a process.

- `--sqlid` | `-s` (string)

  - Specifies the authorization ID that is used in generated SET CURRENT SQLID statements.

- `--termination-character` | `--tc` (string)

  - Specifies the SQL termination character to use in DDL generation when the default termination character conflicts with the SQL statements that are used in triggers, XML indexes, and routines (external SQL functions and native SQL stored procedures). The default termination character is a semi-colon (;). You cannot specify a comma, double quote, single quote, left or right parentheses, or an underscore.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all DBM DS resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### 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

- Generate a migration script for a tablespace and its child table:

  - `zowe dbm-db2 prepare migration --object "tablespace my.tbsp include(table)" --source-db2 SRC --target-db2 TRG --output-migrate-script migrate.txt`

- Generate a migration script and apply global changes:

  - `zowe dbm-db2 prepare migration --object "database my.db include(children)" --source-db2 SRC --target-db2 TRG --change-set USER1.CHANGSET --output-migrate-script migrate.txt --output-ddl-file objects.sql`

## zowe › endevor

Endevor plug-in for listing Endevor environment information, working with elements and packages located in specified Endevor instance.

## zowe › endevor › add

Add an Element into Endevor.

### zowe › endevor › add › element

The add element command lets you add an Element to an Environment entry Stage in Endevor.

#### Usage

zowe endevor add element <element> [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--ccid` | `--cci` (string)

  - The CCID you want to use when performing an Element action.

- `--comment` | `--com` (string)

  - The comment you want to have when performing an Element action

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### input sources options

- `--from-file` | `--ff` (string)

  - Use this input to provide source file.

- `--from-dataset` | `--fd` (string)

  - Use this input to provide source data set name.

- `--from-member` | `--fm` (string)

  - Use this input to provide source member name in the data set.

- `--from-path` | `--fp` (string)

  - Use this input to provide the path of source USS file. It must be used with from-uss-file.

- `--from-uss-file` | `--fuf` (string)

  - Use this input to provide source USS file name. It must be used with from-path

#### options

- `--override-signout` | `--os` (boolean)

  - Specify if you want to override the Signout of an Endevor element while performing this action.

- `--new-version` | `--nv` (number)

  - Assign a different version number to the Element.

- `--proc-group` | `--pg` (string)

  - The Endevor processor group you would like to use.

- `--generate` | `-g` (boolean)

  - Specifies if you want to Generate Element after Add/Update action.

- `--get-fingerprint` | `--gfg` (boolean)

  - Return fingerprint of a retrieved, added or updated element as the first line of the response.

    Default value: false

- `--fingerprint` | `--fg` (string)

  - Specifies the fingerprint of the element to Add or Update. Use value 'NEW' when adding a new element that shouldn't exist in the map yet.

- `--charset` | `--char` (string)

  - Specifies the clients preferred character set when retrieving, printing or updating elements.

    Default value: false

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Add element from local file with endevor profile set up:

  - `zowe endevor add element elementName --env ENV --sys SYS --sub SUB --typ TYPE --ff localfile.txt -i ENDEVOR --ccid CCID --comment 'adding element'`

## zowe › endevor › approve

Approve a Package in Endevor.

### zowe › endevor › approve › package

The approve package command approves Package in Endevor for execution.

#### Usage

zowe endevor approve package [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### options

- `--notes` | `-n` (string)

  - Notes for package.

- `--notes-from-file` | `--nff` (string)

  - Local file of notes for package.

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Approve package with endevor profile set up, specifying approval notes:

  - `zowe endevor approve package packageName -n "notes" -i ENDEVOR`

## zowe › endevor › backin

Backin a Package in Endevor.

### zowe › endevor › backin › package

The backin package command reverses the backout action and returns the Package to a status of Executed.

#### Usage

zowe endevor backin package [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### options

- `--statement` | `--stmn` (number)

  - Specify the SCL statement number for the Element action that you want to back in or back out.

- `--element` | `--elm` (string)

  - Specify the Element name for the Element action that you want to back in or back out.

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Backin package with endevor profile set up:

  - `zowe endevor backin package packageName -i ENDEVOR`

## zowe › endevor › backout

Backout a Package in Endevor.

### zowe › endevor › backout › package

The backout package command restores the executable and output modules of the Package to the status they were in before execution.

#### Usage

zowe endevor backout package [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### options

- `--statement` | `--stmn` (number)

  - Specify the SCL statement number for the Element action that you want to back in or back out.

- `--element` | `--elm` (string)

  - Specify the Element name for the Element action that you want to back in or back out.

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Backout package with endevor profile set up:

  - `zowe endevor backout package packageName -i ENDEVOR`

## zowe › endevor › cast

Cast a Package in Endevor.

### zowe › endevor › cast › package

The cast package command prepares the Package for review and subsequent execution. Casting a Package freezes the contents of the Package and prevents further changes to the Package.

#### Usage

zowe endevor cast package [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### options

- `--from-date-time` | `--fdt` (string)

  - Specify the beginning of time frame within which the package can be executed. Use yyyy-mm-ddThh:mm or see ISO 8601 standard for syntax.

- `--to-date-time` | `--tdt` (string)

  - Specify the end of time frame within which the package can be executed. Use yyyy-mm-ddThh:mm or see ISO 8601 standard for syntax.

- `--validate-components` | `--vc` (string)

  - Specify "yes" to enable component validation within the package, "no" to disable, and "warn" to generate a warning if component validation fails.

    Allowed values: yes, no, warn

- `--backout` (boolean)

  - Set this option to false (or specify --no-backout) if you don't want to have the backout facility available for this package. By default backout is enabled.

    Default value: true

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Cast package with endevor profile set up, changing the execution window of the Package:

  - `zowe endevor cast package packageName --fdt 2018-01-01T00:00 --tdt 2018-12-31T12:00 -i ENDEVOR`

## zowe › endevor › check

Endevor Web Services Health Check.

### zowe › endevor › check › instance

The check instance command triggers the web services health check for a given instance.

#### Usage

zowe endevor check instance [instance] [options]

#### Positional Arguments

- `instance` (string)

  - Specifies Endevor Web Services dataSource name.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### endevor-location definition options

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Perform health check of Endevor Web Services instance ENDEVOR:

  - `zowe endevor check instance ENDEVOR`

## zowe › endevor › commit

Commit a Package in Endevor.

### zowe › endevor › commit › package

The commit package command commits a Package, which removes all backout/backin data while retaining Package event information.

#### Usage

zowe endevor commit package [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### options

- `--older-than` | `--ot` (number)

  - Specify the minimum age of the package.

- `--delete-promotion-history` | `--dph` (boolean)

  - Specifies whether you want to delete all promotion history associated with previous versions of the Package

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Commit package with endevor profile set up, specifying deletion of all promotion history:

  - `zowe endevor commit package packageName --delete-promotion-history -i ENDEVOR`

## zowe › endevor › confirm

Confirm a manual conflict resolution inside an Endevor workspace file is complete.

### zowe › endevor › confirm › resolution

Confirm a manual conflict resolution inside an Endevor workspace file is complete.

#### Usage

zowe endevor confirm resolution [workspace-file] [options]

#### Positional Arguments

- `workspace-file` (string)

  - An Endevor workspace file (full or relative path).

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- Confirm a manual conflict resolution has been finished for file 'filename':

  - `zowe endevor confirm resolution filename`

## zowe › endevor › create

Create a Package in Endevor.

### zowe › endevor › create › package

The create package command lets you create a package in Endevor.

#### Usage

zowe endevor create package [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### input sources options

- `--from-file` | `--ff` (string)

  - Use this input to provide source file.

- `--from-dataset` | `--fd` (string)

  - Use this input to provide source data set name.

- `--from-member` | `--fm` (string)

  - Use this input to provide source member name in the data set.

- `--from-package` | `--fp` (string)

  - Directs the Create/Update action to copy the SCL from the package you specify into the package you are creating or updating.

- `--from-text` | `--ft` (string)

  - Provides a string to use as input SCL.

#### options

- `--description` | `-d` (string)

  - Allows you to associate a 50-character description when creating or updating package.

- `--from-date-time` | `--fdt` (string)

  - Specify the beginning of time frame within which the package can be executed. Use yyyy-mm-ddThh:mm or see ISO 8601 standard for syntax.

- `--to-date-time` | `--tdt` (string)

  - Specify the end of time frame within which the package can be executed. Use yyyy-mm-ddThh:mm or see ISO 8601 standard for syntax.

- `--backout` (boolean)

  - Set this option to false (or specify --no-backout) if you don't want to have the backout facility available for this package. By default backout is enabled.

    Default value: true

- `--notes` | `-n` (string)

  - Notes for package.

- `--notes-from-file` | `--nff` (string)

  - Local file of notes for package.

- `--emergency-package` | `--ep` (boolean)

  - Specify if the package should be an emergency package. When not specified, the package is a standard package.

- `--sharable` | `--sh` (boolean)

  - Specify this option if the package can be edited by more than one person when in In-edit status.

- `--promotion` | `--pr` (boolean)

  - Specify this option to define the package as a promotion package.

- `--validate-scl` | `--vs` (boolean)

  - Set this option to false (or specify --no-validate-scl) to skip validion of the package components while creating a package. By default the SCL is validated

    Default value: true

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Create package from local file with endevor profile set up:

  - `zowe endevor create package packageName -d "package description" --ff localfile.txt -i ENDEVOR`

## zowe › endevor › delete

Delete an Element or a Package in Endevor.

### zowe › endevor › delete › element

The delete element command deletes an Element from the specified inventory location in Endevor.

#### Usage

zowe endevor delete element <element> [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: 1, 2

- `--ccid` | `--cci` (string)

  - The CCID you want to use when performing an Element action.

- `--comment` | `--com` (string)

  - The comment you want to have when performing an Element action

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--proc-group` | `--pg` (string)

  - The Endevor processor group you would like to use.

- `--override-signout` | `--os` (boolean)

  - Specify if you want to override the Signout of an Endevor element while performing this action.

- `--only-components` | `--oc` (boolean)

  - Applicable for Endevor ACM users only. Indicates whether you want to delete both the Element component list and the Element, or the Element component list only. "No" is the default option

- `--where-ccid-all` | `--wca` (string)

  - Instructs Endevor to search both the Master Control File and the SOURCE DELTA levels for a specified CCIDs.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-current` | `--wcc` (string)

  - Instructs Endevor to search through the CCID fields in the Master Control File to find a specified CCIDs.
    Accept up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-retrieve` | `--wcr` (string)

  - Instructs Endevor to use the CCID in the Master Control File RETRIEVE CCID field.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-proc-group` | `--wpg` (string)

  - Lets you select Elements according to a specified Processor group. You can use a wildcard when specifying the Processor group name.
    Accepts up to 8 Processor group names separated by ", ".

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Delete element with endevor profile set up:

  - `zowe endevor delete element elementName --env ENV --sn 1 --sys SYS --sub SUB --typ TYPE -i ENDEVOR`

### zowe › endevor › delete › package

The delete package command lets you delete Packages of any status type in Endevor.

#### Usage

zowe endevor delete package [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### options

- `--status` | `--st` (string)

  - Specify the status of the packages. Valid values are [APPROVED, EXECFAILED] for execute action, and additional values [INEDIT, INAPPROVAL, INEXECUTION, EXECUTED, COMMITTED, DENIED] for list action, additional value [ALLSTATE] for delete action.
    It is possible to specify multiple status separated by "," during list and delete package.

    Allowed values: ALLSTATE, INEDIT, INAPPROVAL, APPROVED, INEXECUTION, EXECUTED, COMMITTED, DENIED, EXECFAILED

- `--older-than` | `--ot` (number)

  - Specify the minimum age of the package.

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Delete package with endevor profile set up:

  - `zowe endevor delete package packageName -i ENDEVOR`

## zowe › endevor › deny

Deny a Package in Endevor.

### zowe › endevor › deny › package

The deny package command changes the status of a Package to Denied.

#### Usage

zowe endevor deny package [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### options

- `--notes` | `-n` (string)

  - Notes for package.

- `--notes-from-file` | `--nff` (string)

  - Local file of notes for package.

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Deny package with endevor profile set up, specifying denial notes:

  - `zowe endevor deny package packageName -n "notes" -i ENDEVOR`

## zowe › endevor › execute

Execute a Package in Endevor.

### zowe › endevor › execute › package

The execute package command executes a Package that have a status of Approved or Execfailed.

#### Usage

zowe endevor execute package [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### options

- `--from-date-time` | `--fdt` (string)

  - Specify the beginning of time frame within which the package can be executed. Use yyyy-mm-ddThh:mm or see ISO 8601 standard for syntax.

- `--to-date-time` | `--tdt` (string)

  - Specify the end of time frame within which the package can be executed. Use yyyy-mm-ddThh:mm or see ISO 8601 standard for syntax.

- `--status` | `--st` (string)

  - Specify the status of the packages. Valid values are [APPROVED, EXECFAILED] for execute action, and additional values [INEDIT, INAPPROVAL, INEXECUTION, EXECUTED, COMMITTED, DENIED] for list action, additional value [ALLSTATE] for delete action.
    It is possible to specify multiple status separated by "," during list and delete package.

    Allowed values: ALLSTATE, INEDIT, INAPPROVAL, APPROVED, INEXECUTION, EXECUTED, COMMITTED, DENIED, EXECFAILED

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Execute package with endevor profile set up, specifying the time frame within which to execute the Package:

  - `zowe endevor execute package packageName --fdt 2018-01-01T00:00 --tdt 2018-12-31T12:00 -i ENDEVOR`

## zowe › endevor › generate

Generate an Element in Endevor.

### zowe › endevor › generate › element

The generate element command executes the generate Processor for the current level of the Element.

#### Usage

zowe endevor generate element <element> [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: 1, 2

- `--ccid` | `--cci` (string)

  - The CCID you want to use when performing an Element action.

- `--comment` | `--com` (string)

  - The comment you want to have when performing an Element action

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--proc-group` | `--pg` (string)

  - The Endevor processor group you would like to use.

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

- `--copy-back` | `--cb` (boolean)

  - Specify if you want to copy the current level of the Element back to the FROM Stage, then perform this action. Do not use with --nosource option.

- `--override-signout` | `--os` (boolean)

  - Specify if you want to override the Signout of an Endevor element while performing this action.

- `--nosource` | `--ns` (boolean)

  - Specify if you want to have source-less Element. Do not use with --copy-back option.

- `--where-ccid-all` | `--wca` (string)

  - Instructs Endevor to search both the Master Control File and the SOURCE DELTA levels for a specified CCIDs.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-current` | `--wcc` (string)

  - Instructs Endevor to search through the CCID fields in the Master Control File to find a specified CCIDs.
    Accept up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-retrieve` | `--wcr` (string)

  - Instructs Endevor to use the CCID in the Master Control File RETRIEVE CCID field.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-proc-group` | `--wpg` (string)

  - Lets you select Elements according to a specified Processor group. You can use a wildcard when specifying the Processor group name.
    Accepts up to 8 Processor group names separated by ", ".

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Generate an element with endevor profile set up, specifying option Copyback:

  - `zowe endevor generate element elementName --env ENV --sn 1 --sys SYS --sub SUB --typ TYPE --cb -i ENDEVOR`

## zowe › endevor › initialize

Initialize a directory as an Endevor workspace.

### zowe › endevor › initialize › workspace

Initialize current directory as an Endevor workspace.

#### Usage

zowe endevor initialize workspace [workspace-dir] [options]

#### Positional Arguments

- `workspace-dir` (string)

  - The Endevor workspace directory, if different from current working directory.

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- initialize current directory as an Endevor workspace:

  - `zowe endevor initialize workspace`

- initialize 'myWorkspace' directory as an Endevor workspace:

  - `zowe endevor initialize workspace 'myWorkspace'`

## zowe › endevor › list

List instances, elements, types, packages and inventory locations in Endevor.

### zowe › endevor › list › code-page-config

The list code-page-config command lists the EBCDIC code page mapping rules used by Endevor Web Services

#### Usage

zowe endevor list code-page-config [options]

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### endevor-location definition options

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List codepage-config with session specified:

  - `zowe endevor list code-page-config --host hostName --port 8080`

### zowe › endevor › list › defaults

List the contents of the main Endevor configuration table (C1DEFLTS)

#### Usage

zowe endevor list defaults [options]

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### endevor-location definition options

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List the contents of the main Endevor configuration table (C1DEFLTS):

  - `zowe endevor list defaults`

### zowe › endevor › list › dialog

List the contents of the Endevor ISPF dialog defaults table (ENDIECFG)

#### Usage

zowe endevor list dialog [options]

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### endevor-location definition options

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List the contents of the Endevor ISPF dialog defaults table (ENDIECFG):

  - `zowe endevor list dialog`

### zowe › endevor › list › elements

The list elements command lists element information in Endevor

#### Usage

zowe endevor list elements [element] [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: \*, \%, 1, 2

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--path` | `--pa` (string)

  - Specifies a PHYsical or LOGical path.

    Allowed values: log, phy

- `--return` | `--ret` (string)

  - Sets mapping options for returned results: return FIRst match or ALL matching results.

    Allowed values: fir, all

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

- `--data` | `--dat` (string)

  - Allows to select the type of summary data returned in the element list:
    ALL - Full element information
    BAS - Basic element information
    ELE - Element change level summary
    COMP - Component change level summary

    When data=ALL --fo (full-output) always takes place unless there is a --rff (response-format-filter).
    In all other cases default set of columns will be shown.

    Allowed values: all, bas, ele, comp

- `--where-ccid-current` | `--wcc` (string)

  - Instructs Endevor to search through the CCID fields in the Master Control File to find a specified CCIDs.
    Accept up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-generate` | `--wcg` (string)

  - Instructs Endevor to search using the generate CCID associated with an Element.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-lastact` | `--wcla` (string)

  - Instructs Endevor to search using the last action CCID associated with an Element.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-lastlvl` | `--wcll` (string)

  - Instructs Endevor to search using the last level CCID associated with an Element.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-change` | `--wcchg` (string)

  - This option is only valid when the data option is ele or comp. Instructs Endevor to filter the results of the list data summary function that is based on the specified ccids.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-retrieve` | `--wcr` (string)

  - Instructs Endevor to use the CCID in the Master Control File RETRIEVE CCID field.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-proc-type` | `--wpt` (string)

  - Lets you select Elements according to a specified Processor type.

    Allowed values: GEN, GENERATE, MOV, MOVE, DEL, DELETE

- `--where-proc-group` | `--wpg` (string)

  - Lets you select Elements according to a specified Processor group. You can use a wildcard when specifying the Processor group name.
    Accepts up to 8 Processor group names separated by ", ".

- `--limit` | `--lim` (number)

  - Maximum number of results to return, where 0 is NOLIMIT.

#### endevor search text options

- `--search-text` | `--stext` (string)

  - Search string(s) separated with AND or OR. E.g.: string_1 AND string_2 AND string_3 OR string_4.
    For complex search strings with quotation marks use search-text-file parameter.

- `--search-text-file` | `--stf` (string)

  - File which contains search string(s) separated with AND or OR. Recommended for complex search strings with quotation marks.

- `--search-in` | `--si` (string)

  - 2 letters describing where search should be performed:
    es - Element Source
    eh - Element History
    ec - Element Changes
    eu - Element Summary
    cs - Components Source
    ch - Components History
    cc - Components Changes
    cu - Components Summary.

    Allowed values: es, eh, ec, eu, cs, ch, cc, cu

- `--search-from` | `--sf` (number)

  - Beginning interval of the column range for the search-text.

- `--search-to` | `--st` (number)

  - Ending interval of the column range for the search-text.

- `--search-ignore-case` | `--ic` (boolean)

  - Ignore search case.

- `--search-in-binary` | `--bin` (boolean)

  - Should the text search be performed in binary elements.

- `--search-limit` | `--sl` (number)

  - Maximum search limit where 0 is NOLIMIT.

#### scl generation options

- `--to-package` | `--tp` (string)

  - Specifies the package to which the SCL has to be appended. This option requires scl-action

- `--scl-action` | `--sa` (string)

  - Specifies the action for the SCL that has to be built.

    Allowed values: GENERATE, MOVE, DELETE

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List elements in Endevor from the specified inventory location with the endevor profile set up:

  - `zowe endevor list elements -i ENDEVOR --env ENVNAME --sn 1 --sys SYSNAME --sub SUBNAME --typ TYPENAME`

- List elements in Endevor using search text string:

  - `zowe endevor list elements --stext "first or second and third"`

### zowe › endevor › list › environments

The list environments command lists environments in Endevor

#### Usage

zowe endevor list environments [environment] [options]

#### Positional Arguments

- `environment` (string)

  - Name of the Endevor environment.

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--path` | `--pa` (string)

  - Specifies a PHYsical or LOGical path.

    Allowed values: log, phy

- `--return` | `--ret` (string)

  - Sets mapping options for returned results: return FIRst match or ALL matching results.

    Allowed values: fir, all

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List all environments in Endevor with endevor profile set up:

  - `zowe endevor list environments -i ENDEVOR`

### zowe › endevor › list › features

List the contents of the Endevor optional features table (ENCOPTBL)

#### Usage

zowe endevor list features [options]

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### endevor-location definition options

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List the contents of the Endevor optional features table (ENCOPTBL):

  - `zowe endevor list features`

### zowe › endevor › list › instances

The list instances command lists instances used by Endevor Web Services

#### Usage

zowe endevor list instances [options]

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) 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

- `--user` | `-u` (string)

  - User name to authenticate to service on the mainframe.

- `--password` | `--pass` | `--pw` (string)

  - Password to authenticate to service on the mainframe.

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List instances with session specified:

  - `zowe endevor list instances --host hostName --port 8080`

### zowe › endevor › list › packages

The list packages command lists package information in Endevor

#### Usage

zowe endevor list packages [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### options

- `--status` | `--st` (string)

  - Specify the status of the packages. Valid values are [APPROVED, EXECFAILED] for execute action, and additional values [INEDIT, INAPPROVAL, INEXECUTION, EXECUTED, COMMITTED, DENIED] for list action, additional value [ALLSTATE] for delete action.
    It is possible to specify multiple status separated by "," during list and delete package.

    Allowed values: ALLSTATE, INEDIT, INAPPROVAL, APPROVED, INEXECUTION, EXECUTED, COMMITTED, DENIED, EXECFAILED

- `--emergency-package` | `--ep` (boolean)

  - Specify if the package should be an emergency package. When not specified, the package is a standard package.

- `--enterprise` | `--ent` (string)

  - Specify to filter the list by enterprise Package parameter. A - All, E - Enterprise, X - eXclude.

    Allowed values: A, E, X

- `--promotion-status` | `--ps` (string)

  - Specify to filter the list by promotion Package parameter. A - All, P - Promotion, X - eXclude.

    Allowed values: A, P, X

- `--prom-target-env` | `--pte` (string)

  - Promotion target environment. Specifies the promotion package target environment. This field only applies to promotion packages and can only be specified when the promotion package type is A or P.

- `--prom-target-stgID` | `--pts` (string)

  - Promotion target stage ID. Specifies the promotion package target stage ID. This field only applies to promotion packages and can only be specified when the promotion package type is A or P.

- `--approver` | `--apr` (string)

  - Specifies a one to eight character approver ID. Only one approver ID can be specified and name masking is not supported.

- `--limit` | `--lim` (number)

  - Maximum number of results to return, where 0 is NOLIMIT.

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List all packages in Endevor with endevor profile set up:

  - `zowe endevor list packages -i ENDEVOR`

### zowe › endevor › list › processor-groups

The list processor-groups command lists processor group information in Endevor

#### Usage

zowe endevor list processor-groups [proc-group] [options]

#### Positional Arguments

- `proc-group` (string)

  - Name of the Endevor processor group

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: \*, \%, 1, 2

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--path` | `--pa` (string)

  - Specifies a PHYsical or LOGical path.

    Allowed values: log, phy

- `--return` | `--ret` (string)

  - Sets mapping options for returned results: return FIRst match or ALL matching results.

    Allowed values: fir, all

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List processor groups for type TYPENAME with endevor profile set up:

  - `zowe endevor list processor-groups --type TYPENAME --env ENVNAME --sn 1 --sys SYSNAME -i ENDEVOR`

### zowe › endevor › list › processor-symbols

The list processor-symbols command lists processor group symbol overrides information in Endevor

#### Usage

zowe endevor list processor-symbols [proc-group] [options]

#### Positional Arguments

- `proc-group` (string)

  - Name of the Endevor processor group

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: \*, \%, 1, 2

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--path` | `--pa` (string)

  - Specifies a PHYsical or LOGical path.

    Allowed values: log, phy

- `--return` | `--ret` (string)

  - Sets mapping options for returned results: return FIRst match or ALL matching results.

    Allowed values: fir, all

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List all processor symbols for group PROCGROUP with endevor profile set up:

  - `zowe endevor list processor-symbols PROCGROUP --env ENVNAME --sn 1 --sys SYSNAME --typ TYPENAME -i ENDEVOR`

### zowe › endevor › list › stages

The list stages command lists stages in Endevor

#### Usage

zowe endevor list stages [stage] [options]

#### Positional Arguments

- `stage` (string)

  - Name of the Endevor stage

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--path` | `--pa` (string)

  - Specifies a PHYsical or LOGical path.

    Allowed values: log, phy

- `--return` | `--ret` (string)

  - Sets mapping options for returned results: return FIRst match or ALL matching results.

    Allowed values: fir, all

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List all stages in Endevor with endevor profile set up:

  - `zowe endevor list stages -i ENDEVOR`

### zowe › endevor › list › subsystems

The list subsystems command lists subsystem information in Endevor

#### Usage

zowe endevor list subsystems [subsystem] [options]

#### Positional Arguments

- `subsystem` (string)

  - Name of the Endevor subsystem

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: \*, \%, 1, 2

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--path` | `--pa` (string)

  - Specifies a PHYsical or LOGical path.

    Allowed values: log, phy

- `--return` | `--ret` (string)

  - Sets mapping options for returned results: return FIRst match or ALL matching results.

    Allowed values: fir, all

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List all subsystems in Endevor with endevor profile set up:

  - `zowe endevor list subsystems -i ENDEVOR`

### zowe › endevor › list › symbols

List the Endevor site symbols

#### Usage

zowe endevor list symbols [options]

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### endevor-location definition options

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List the Endevor site symbols:

  - `zowe endevor list symbols`

### zowe › endevor › list › systems

The list systems command lists system information in Endevor

#### Usage

zowe endevor list systems [system] [options]

#### Positional Arguments

- `system` (string)

  - Name of the Endevor system

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: \*, \%, 1, 2

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--path` | `--pa` (string)

  - Specifies a PHYsical or LOGical path.

    Allowed values: log, phy

- `--return` | `--ret` (string)

  - Sets mapping options for returned results: return FIRst match or ALL matching results.

    Allowed values: fir, all

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List all systems in Endevor with endevor profile set up:

  - `zowe endevor list systems -i ENDEVOR`

### zowe › endevor › list › tasks

List asynchronous tasks submitted by this user

#### Usage

zowe endevor list tasks [task-id] [options]

#### Positional Arguments

- `task-id` (string)

  - The id of an asynchronous Endevor web service task.

#### asynchronous task options

- `--task-status` (string)

  - Filter tasks by status: in-progress, finished or all.

    Default value: all
    Allowed values: inp, fin, all

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### endevor-location definition options

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List all finished tasks:

  - `zowe endevor list tasks --task-status fin`

- List a specific task to verify its completion status:

  - `zowe endevor list tasks 2789102296850204364`

### zowe › endevor › list › type-sequence

List the contents of the Endevor type sequence

#### Usage

zowe endevor list type-sequence [options]

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### endevor-location definition options

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List the contents of the Endevor type sequence:

  - `zowe endevor list type-sequence`

### zowe › endevor › list › types

The list types command lists type information in Endevor

#### Usage

zowe endevor list types [type] [options]

#### Positional Arguments

- `type` (string)

  - Name of the Endevor type

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: \*, \%, 1, 2

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--path` | `--pa` (string)

  - Specifies a PHYsical or LOGical path.

    Allowed values: log, phy

- `--return` | `--ret` (string)

  - Sets mapping options for returned results: return FIRst match or ALL matching results.

    Allowed values: fir, all

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List all types in Endevor with endevor profile set up:

  - `zowe endevor list types -i ENDEVOR`

## zowe › endevor › merge

Merge Endevor elements from one Endevor location into another

### zowe › endevor › merge › element

Merge Endevor elements from one Endevor location into another. Requires an initialized Endevor workspace to perform conflict resolution. Use "synchronize workspace" command afterwards to push the result back into Endevor.

#### Usage

zowe endevor merge element [element] [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: \*, \%, 1, 2

- `--ccid` | `--cci` (string)

  - The CCID you want to use when performing an Element action.

- `--comment` | `--com` (string)

  - The comment you want to have when performing an Element action

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### merge-location definition options

- `--merge-environment` | `--menv` (string)

  - Merge elements from this environment to the target environment (specified by 'environment'). Defaults to the same environment as the target.

- `--merge-stage-number` | `--msn` (string)

  - Merge elements from this stage number into the target stage number (specified by 'stage-number'). Defaults to the same stage number as the target.

- `--merge-system` | `--msys` (string)

  - Merge elements from this system into the target system (specified by 'system'). Defaults to the same system as the target.

- `--merge-subsystem` | `--msub` (string)

  - Merge elements from this subsystem into the target subsystem (specified by 'subsystem'). Defaults to the same subsystem as the target.

- `--merge-out-of-sync` | `--moos` (boolean)

  - Merge out-of-sync elements at the target location with their next version in the map, and attempt to resolve the out-of-sync during the next synchronization with Endevor.

#### workspace options

- `--workspace-dir` | `--wsp` (string)

  - The Endevor workspace directory, if different from current working directory.

    Default value: .

- `--dry-run` | `--dr` (boolean)

  - List all actions the synchronization would perform, without executing them.

- `--limit` | `--lim` (number)

  - If the synchronization would need to perform more than 'limit' Endevor actions, do not perform the actions now, only report them. 0 means no limit.

    Default value: 0

#### options

- `--override-signout` | `--os` (boolean)

  - Specify if you want to override the Signout of any Endevor elements affected by this action.

- `--signout` (boolean)

  - Specify if you want to perform the action with signing out any retrieved elements.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Merge element ELEMENT1 of type COBPGM from subsystem SUBFROM into the same element found in subsystem SUBTO (system, stage and env taken from current location profile):

  - `zowe endevor merge element ELEMENT1 --type COBPGM --subsystem SUBTO --merge-subsystem SUBFROM`

- Merge any elements that are currently out of sync with their next element version up the map (map location determined by current profile):

  - `zowe endevor merge element * --merge-out-of-sync`

- Report which elements are currently out of sync with their next element version up the map, but do not merge them yet (map location determined by current profile):

  - `zowe endevor merge element * --merge-out-of-sync --dry-run`

- Merge all elements from system SYSFROM, subsystem SUBFROM into matching elements in system SYSTO subsystem SUBTO (system, stage and env taken from current location profile):

  - `zowe endevor merge element * --system SYSTO --subsystem SUBTO --merge-system SYSFROM --merge-subsystem SUBFROM`

- Merge element ELEMENT1 of type COBPGM from subsystem SUBFROM into SUBTO, retrieving both elements using the provided ccid & comment, with signout, and overriding signout if necessary:

  - `zowe endevor merge element ELEMENT1 --type COBPGM --subsystem SUBTO --merge-subsystem SUBFROM --ccid MYCCID --comment 'my comment' --signout --overrride-signout`

## zowe › endevor › move

Move an Element in Endevor.

### zowe › endevor › move › element

The move element command moves Elements between inventory locations along a map.

#### Usage

zowe endevor move element <element> [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: 1, 2

- `--ccid` | `--cci` (string)

  - The CCID you want to use when performing an Element action.

- `--comment` | `--com` (string)

  - The comment you want to have when performing an Element action

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--proc-group` | `--pg` (string)

  - The Endevor processor group you would like to use.

- `--sync` | `-s` (boolean)

  - Specify if you want to synchronize source and current level of the Elements while performing this action.

- `--with-history` | `--wh` (boolean)

  - Specify if you want to preserve the change history of the Elements while performing this action.

- `--bypass-element-delete` | `--bed` (boolean)

  - Specify if you want to retain the Elements in the source Stage after successfully completing this action.

- `--retain-signout` | `--rs` (boolean)

  - Specify if you want to retain the source location signouts for all Elements at the target location while performing this action.

- `--signout-to` | `--st` (string)

  - Specify if you want to sign all Elements out to the specified user ID at the target Stage while performing this action.

- `--jump` | `-j` (boolean)

  - Specify if you want to move Elements across Environments even if those Elements exist at an intermediate Stage that is not on the map, while performing this action.

- `--where-ccid-all` | `--wca` (string)

  - Instructs Endevor to search both the Master Control File and the SOURCE DELTA levels for a specified CCIDs.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-current` | `--wcc` (string)

  - Instructs Endevor to search through the CCID fields in the Master Control File to find a specified CCIDs.
    Accept up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-retrieve` | `--wcr` (string)

  - Instructs Endevor to use the CCID in the Master Control File RETRIEVE CCID field.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-proc-group` | `--wpg` (string)

  - Lets you select Elements according to a specified Processor group. You can use a wildcard when specifying the Processor group name.
    Accepts up to 8 Processor group names separated by ", ".

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Move element from specified inventory location with endevor profile set up:

  - `zowe endevor move element elementName --env ENV --sn 1 --sys SYS --sub SUB --typ TYPE -i ENDEVOR`

## zowe › endevor › print

Print an Element or a Component in Endevor.

### zowe › endevor › print › components

The print component command prints selected component information about Element in Endevor.

#### Usage

zowe endevor print components <element> [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: 1, 2

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--level` | `--lev` (number)

  - Indicates the level number of the element (use along with the version option).

- `--element-version` | `--ev` (number)

  - Indicates the version number of the element (use along with the level option).

- `--print-comp` | `--pc` (string)

  - Specify the type of data to print out for print component command

    Default value: browse
    Allowed values: browse, changes, history, summary

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

- `--headings` (boolean)

  - Specify it if you want to print a header on each page.

- `--explode` | `--exp` | `--ex` (boolean)

  - Specify to print component info from ACMQ.

- `--where-ccid-current` | `--wcc` (string)

  - Instructs Endevor to search through the CCID fields in the Master Control File to find a specified CCIDs.
    Accept up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-all` | `--wca` (string)

  - Instructs Endevor to search both the Master Control File and the SOURCE DELTA levels for a specified CCIDs.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-retrieve` | `--wcr` (string)

  - Instructs Endevor to use the CCID in the Master Control File RETRIEVE CCID field.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-proc-group` | `--wpg` (string)

  - Lets you select Elements according to a specified Processor group. You can use a wildcard when specifying the Processor group name.
    Accepts up to 8 Processor group names separated by ", ".

- `--charset` | `--char` (string)

  - Specifies the clients preferred character set when retrieving, printing or updating elements.

    Default value: false

#### output customization options

- `--to-file` | `--tf` (string)

  - The file name in which the data from the command output is stored

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Print selected component information about Element with endevor profile set up:

  - `zowe endevor print components elementName --env ENV --sn 1 --sys SYS --sub SUB --typ TYPE -i ENDEVOR`

### zowe › endevor › print › element

The print element command prints selected information about Element in Endevor.

#### Usage

zowe endevor print element <element> [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: \*, \%, 1, 2

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--level` | `--lev` (number)

  - Indicates the level number of the element (use along with the version option).

- `--element-version` | `--ev` (number)

  - Indicates the version number of the element (use along with the level option).

- `--print` (string)

  - Specify the type of data to print out for print element command

    Default value: browse
    Allowed values: browse, changes, history, summary, master, listing

- `--list-string` | `--ls` (string)

  - Specifies the one to eight character text-string used to identify the listing data set to print.

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

- `--headings` (boolean)

  - Specify it if you want to print a header on each page.

- `--explode` | `--exp` | `--ex` (boolean)

  - Specify to print component info from ACMQ.

- `--expand-includes` | `--expand` | `--ei` (boolean)

  - Indicates that INCLUDE statements should be expanded in the course of the action.

- `--where-ccid-current` | `--wcc` (string)

  - Instructs Endevor to search through the CCID fields in the Master Control File to find a specified CCIDs.
    Accept up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-all` | `--wca` (string)

  - Instructs Endevor to search both the Master Control File and the SOURCE DELTA levels for a specified CCIDs.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-retrieve` | `--wcr` (string)

  - Instructs Endevor to use the CCID in the Master Control File RETRIEVE CCID field.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-proc-group` | `--wpg` (string)

  - Lets you select Elements according to a specified Processor group. You can use a wildcard when specifying the Processor group name.
    Accepts up to 8 Processor group names separated by ", ".

- `--charset` | `--char` (string)

  - Specifies the clients preferred character set when retrieving, printing or updating elements.

    Default value: false

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### output customization options

- `--to-file` | `--tf` (string)

  - The file name in which the data from the command output is stored

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Print element from specified inventory location with endevor profile set up:

  - `zowe endevor print element elementName --env ENV --sn 1 --sys SYS --sub SUB --typ TYPE -i ENDEVOR`

### zowe › endevor › print › member

The print member command prints a member from a specified dataset.

#### Usage

zowe endevor print member <member> [options]

#### Positional Arguments

- `member` (string)

  - Name of the member.

#### input sources options

- `--from-dataset` | `--fd` (string)

  - Use this input to provide source data set name.

#### options

- `--headings` (boolean)

  - Specify it if you want to print a header on each page.

- `--charset` | `--char` (string)

  - Specifies the clients preferred character set when retrieving, printing or updating elements.

    Default value: false

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### output customization options

- `--to-file` | `--tf` (string)

  - The file name in which the data from the command output is stored

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### endevor-location definition options

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Print a member from specified dataset:

  - `zowe endevor print member memName --fd DSNAME -i ENDEVOR`

## zowe › endevor › queryacm

Query Elements and information about their components in Endevor.

### zowe › endevor › queryacm › components

Query components used by a specified Element with the Endevor ACM Query facility.

#### Usage

zowe endevor queryacm components <element> [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: \*, \%, 1, 2

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--excCirculars` | `--exc` (boolean)

  - Filters the result to exclude components that have a circular relationship to the subject of your search.

- `--excIndirect` | `--exi` (boolean)

  - Filters the result to exclude indirectly related components.

- `--excRelated` | `--exr` (boolean)

  - Filters the result to exclude related components.

#### output customization options

- `--full-output` | `--fo` (boolean)

  - Specify this option if you want a full output of list action.

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- query all the components used by element "elementName" from the specified inventory location with the endevor profile set up:

  - `zowe endevor queryacm components elementName --env ENVNAME --sn 1 --sys SYSNAME --sub SUBNAME --typ TYPENAME -i ENDEVOR`

## zowe › endevor › reset

Reset a Package in Endevor.

### zowe › endevor › reset › package

The reset package command lets you set the status of a Package back to In-edit so you can modify it.

#### Usage

zowe endevor reset package [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Reset package with endevor profile set up:

  - `zowe endevor reset package packageName -i ENDEVOR`

## zowe › endevor › retrieve

Retrieve an Element in Endevor.

### zowe › endevor › retrieve › element

The retrieve element command retrieves an existing element in Endevor.

#### Usage

zowe endevor retrieve element <element> [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: \*, \%, 1, 2

- `--ccid` | `--cci` (string)

  - The CCID you want to use when performing an Element action.

- `--comment` | `--com` (string)

  - The comment you want to have when performing an Element action

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--element-version` | `--ev` (number)

  - Indicates the version number of the element (use along with the level option).

- `--level` | `--lev` (number)

  - Indicates the level number of the element (use along with the version option).

- `--override-signout` | `--os` (boolean)

  - Specify if you want to override the Signout of an Endevor element while performing this action.

- `--signout` (boolean)

  - Specify if you want to perform the action with signing the element out.

- `--replace-member` | `--replace` | `--rm` (boolean)

  - Specify if you want to replace the member currently in the library with the new element contents

- `--expand-includes` | `--expand` | `--ei` (boolean)

  - Indicates that INCLUDE statements should be expanded in the course of the action.

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

- `--get-fingerprint` | `--gfg` (boolean)

  - Return fingerprint of a retrieved, added or updated element as the first line of the response.

    Default value: false

- `--where-ccid-all` | `--wca` (string)

  - Instructs Endevor to search both the Master Control File and the SOURCE DELTA levels for a specified CCIDs.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-current` | `--wcc` (string)

  - Instructs Endevor to search through the CCID fields in the Master Control File to find a specified CCIDs.
    Accept up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-retrieve` | `--wcr` (string)

  - Instructs Endevor to use the CCID in the Master Control File RETRIEVE CCID field.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-proc-group` | `--wpg` (string)

  - Lets you select Elements according to a specified Processor group. You can use a wildcard when specifying the Processor group name.
    Accepts up to 8 Processor group names separated by ", ".

- `--charset` | `--char` (string)

  - Specifies the clients preferred character set when retrieving, printing or updating elements.

    Default value: false

#### output location options

- `--to-path` | `--tp` (string)

  - Provide a USS path to a destination location.

- `--to-uss-file` | `--tuf` (string)

  - Provide a USS file as a destination file.

- `--to-dataset` | `--td` (string)

  - Provide a destination data set name.

- `--to-member` | `--tm` (string)

  - Provide a destination member name inside the data set.

#### output customization options

- `--to-file` | `--tf` (string)

  - The file name in which the data from the command output is stored

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### bulk action options

- `--to-dir` | `--tdir` (string)

  - Directory name in which the command output will be stored.

- `--flat` (boolean)

  - Store the output of the bulk action within one folder. When you use this option, ensure that the results do not contain duplicate names. (Duplicate names occur when two or more Elements have the same name and type.)

- `--with-dependencies` | `--wd` (boolean)

  - Retrieve Elements, including their Endevor-managed input components.

- `--where-ccid-generate` | `--wcg` (string)

  - Instructs Endevor to search using the generate CCID associated with an Element.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-lastact` | `--wcla` (string)

  - Instructs Endevor to search using the last action CCID associated with an Element.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-lastlvl` | `--wcll` (string)

  - Instructs Endevor to search using the last level CCID associated with an Element.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-change` | `--wcchg` (string)

  - This option is only valid when the data option is ele or comp. Instructs Endevor to filter the results of the list data summary function that is based on the specified ccids.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--file-extension` | `--ext` (string)

  - The strategy for deciding what file extension to use during a bulk retrieve or workspace synchronization. Must be one of the following:

          none: File name is equal to element name, no extension is added.

          file\-ext: The file extension defined in the Type definition is used; If not defined, no extension is added.

          type\-name: The type name is used as the file extension.

          mixed: The file extension defined in Type definition is used; If not defined, the type name is used instead.

    Default value: mixed
    Allowed values: none, file-ext, type-name, mixed

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Retrieve element from specified inventory location to local file with endevor profile set up:

  - `zowe endevor retrieve element elementName --env ENVNAME --sn 1 --sys SYSNAME --sub SUBNAME --typ TYPENAME --tf localfile.txt -i ENDEVOR`

- Bulk Retrieve elements with wildcarded element name and type, to local directory with endevor profile set up:

  - `zowe endevor retrieve element "*" --env ENVNAME --sn 1 --sys SYSNAME --sub SUBNAME --typ "*" --to-dir /user/localdir -i ENDEVOR`

### zowe › endevor › retrieve › result

Retrieve the result of an asynchronous task

#### Usage

zowe endevor retrieve result [task-id] [options]

#### Positional Arguments

- `task-id` (string)

  - The id of an asynchronous Endevor web service task.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### endevor-location definition options

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Retrieve the result of task 2789102296850204364:

  - `zowe endevor retrieve result 2789102296850204364`

## zowe › endevor › signin

Signin an Element in Endevor.

### zowe › endevor › signin › element

The signin element command signs in an existing element in Endevor.

#### Usage

zowe endevor signin element <element> [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: 1, 2

- `--ccid` | `--cci` (string)

  - The CCID you want to use when performing an Element action.

- `--comment` | `--com` (string)

  - The comment you want to have when performing an Element action

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--proc-group` | `--pg` (string)

  - The Endevor processor group you would like to use.

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

- `--override-signout` | `--os` (boolean)

  - Specify if you want to override the Signout of an Endevor element while performing this action.

- `--signout-to` | `--st` (string)

  - Specify if you want to sign all Elements out to the specified user ID at the target Stage while performing this action.

- `--where-ccid-all` | `--wca` (string)

  - Instructs Endevor to search both the Master Control File and the SOURCE DELTA levels for a specified CCIDs.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-current` | `--wcc` (string)

  - Instructs Endevor to search through the CCID fields in the Master Control File to find a specified CCIDs.
    Accept up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-retrieve` | `--wcr` (string)

  - Instructs Endevor to use the CCID in the Master Control File RETRIEVE CCID field.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-proc-group` | `--wpg` (string)

  - Lets you select Elements according to a specified Processor group. You can use a wildcard when specifying the Processor group name.
    Accepts up to 8 Processor group names separated by ", ".

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Signin element with endevor profile set up:

  - `zowe endevor signin element elementName --env ENV --sn 1 --sys SYS --sub SUB --typ TYPE -i ENDEVOR`

## zowe › endevor › submit

Submit a Package or a SCL file in Endevor.

### zowe › endevor › submit › package

The submit package command submits a JCL job stream to execute one or more Packages.

#### Usage

zowe endevor submit package [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### input sources options

- `--from-file` | `--ff` (string)

  - Use this input to provide source file.

- `--from-dataset` | `--fd` (string)

  - Use this input to provide source data set name.

- `--from-member` | `--fm` (string)

  - Use this input to provide source member name in the data set.

#### output location options

- `--to-CA7` | `--t7` (boolean)

  - Specify to send the submission of the package to CA 7 scheduler.

- `--to-ddname` | `--tdd` (string)

  - Send the submission of the package to be processed according to a DDName specified in the starter task (STC).

#### options

- `--status` | `--st` (string)

  - Specify the status of the packages. Valid values are [APPROVED, EXECFAILED] for execute action, and additional values [INEDIT, INAPPROVAL, INEXECUTION, EXECUTED, COMMITTED, DENIED] for list action, additional value [ALLSTATE] for delete action.
    It is possible to specify multiple status separated by "," during list and delete package.

    Allowed values: ALLSTATE, INEDIT, INAPPROVAL, APPROVED, INEXECUTION, EXECUTED, COMMITTED, DENIED, EXECFAILED

- `--multiple-streams` | `--ms` (boolean)

  - Specify to submit a separate, unique job for each package. If you do not specify this, a single job with a unique job step for each package is submitted.

- `--increment-jobname` | `--ij` (boolean)

  - Specify to increases the last character in the jobcard you provide.

- `--jcl-procedure` | `--jp` (string)

  - This option lets you to identify the name of the JCL procedure that you want to invoke. ENDEVOR is used by default if any processor is specified.

- `--CA7-dependent-job` | `--7dj` (string)

  - Specifies a single predecessor job which must complete while demanded job is waiting in the CA 7 scheduler.

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Submit package using jobcard from local file, with endevor profile set up:

  - `zowe endevor submit package packageName --ff jobcardfile.txt -i ENDEVOR`

### zowe › endevor › submit › scl

The submit scl commands submits a SCL file to be executed.

#### Usage

zowe endevor submit scl [options]

#### options

- `--scl-file` | `--sf` | `--sclf` (string)

  - The file which contains the Endevor SCL you would like to submit.

- `--scl-type` | `--sclt` (string)

  - The category of Endevor SCL.

    Allowed values: list, element, package, admin, ship, addUpdRtv

#### input sources options

- `--from-file` | `--ff` (string)

  - Use this input to provide source file.

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Submit a SCL of type element, with endevor profile set up:

  - `zowe endevor submit scl --sf sclfile.txt --sclt element -i ENDEVOR`

## zowe › endevor › synchronize

Synchronize remote Endevor inventory with the local Endevor workspace.

### zowe › endevor › synchronize › workspace

Synchronize a selected subset of remote Endevor inventory with a local Endevor workspace

#### Usage

zowe endevor synchronize workspace [workspace-dir] [options]

#### Positional Arguments

- `workspace-dir` (string)

  - The Endevor workspace directory, if different from current working directory.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: \*, \%, 1, 2

- `--ccid` | `--cci` (string)

  - The CCID you want to use when performing an Element action.

- `--comment` | `--com` (string)

  - The comment you want to have when performing an Element action

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--override-signout` | `--os` (boolean)

  - Specify if you want to override the Signout of any Endevor elements affected by this action.

- `--signout` (boolean)

  - Specify if you want to perform the action with signing out any retrieved elements.

#### workspace options

- `--element` | `--ele` | `--elem` (string)

  - Name filter to synchronize only specific Endevor element(s).

    Default value: *

- `--dry-run` | `--dr` (boolean)

  - List all actions the synchronization would perform, without executing them.

- `--reset` | `--rst` (boolean)

  - Revert any local changes, resetting the local workspace to match the current state of the remote Endevor inventory.

- `--limit` | `--lim` (number)

  - If the synchronization would need to perform more than 'limit' Endevor actions, do not perform the actions now, only report them. 0 means no limit.

    Default value: 0

- `--one-way` (boolean)

  - Do not update Endevor elements with local changes, only retrieve remote changes from Endevor and resolve any conflicts.

- `--allow-deletes` | `--del` (boolean)

  - Allow workspace synchronization to delete unchanged Endevor elements when it detects the corresponding local files have been deleted. Default is off to maintain backward compatibility.

- `--file-extension` | `--ext` (string)

  - The strategy for deciding what file extension to use during a bulk retrieve or workspace synchronization. Must be one of the following:

          none: File name is equal to element name, no extension is added.

          file\-ext: The file extension defined in the Type definition is used; If not defined, no extension is added.

          type\-name: The type name is used as the file extension.

          mixed: The file extension defined in Type definition is used; If not defined, the type name is used instead.

    Default value: mixed
    Allowed values: none, file-ext, type-name, mixed

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Synchronize all elements in the map location defined by the currently active endevor-location profile with current directory:

  - `zowe endevor synchronize workspace`

- Synchronize all elements in the map location defined by the currently active endevor-location profile with workspace directory 'C:/projects/myWorkspace':

  - `zowe endevor synchronize workspace 'C:/projects/myWorkspace'`

- Synchronize all elements in system SYSTEM1 subsystem SUBSYS1 from environment DEV stage 1, whose type begins with 'ASM', with current directory:

  - `zowe endevor synchronize workspace --environment DEV --stage_number 1 --system SYSTEM1 --subsystem SUBSYS1 --type ASM* --ccid myccid --comment 'my changes'`

- Synchronize all elements in the map location defined by the currently active endevor-location profile, whose name is 'PRFX' followed by any 2 characters and ending with '11', with workspace directory 'C:/projects/myWorkspace':

  - `zowe endevor synchronize workspace 'C:/projects/myWorkspace' --ccid myccid --comment 'my changes' --element PRFX%%11`

- Display all actions needed to synchronize all elements in the map location defined by endevor-location profile 'mysandbox' with current directory, without performing them:

  - `zowe endevor synchronize workspace --dry-run --endevor-location-profile mysandbox`

- Revert all local changes in the map location defined by the currently active endevor-location profile, resetting your workspace to match Endevor:

  - `zowe endevor synchronize workspace --reset`

## zowe › endevor › transfer

Transfer an Element in Endevor.

### zowe › endevor › transfer › element

The Transfer element command transfers Elements from one Endevor location to another.

#### Usage

zowe endevor transfer element <element> [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: 1, 2

- `--ccid` | `--cci` (string)

  - The CCID you want to use when performing an Element action.

- `--comment` | `--com` (string)

  - The comment you want to have when performing an Element action

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### output location options

- `--to-environment` | `--toenv` (string)

  - The target Endevor environment.

- `--to-system` | `--tosys` (string)

  - The target Endevor system.

- `--to-subsystem` | `--tosub` (string)

  - The target Endevor subsystem.

- `--to-element` | `--toele` (string)

  - The target Endevor element name.

- `--to-type` | `--totyp` (string)

  - The target Endevor element type.

- `--to-stage-number` | `--tosn` (string)

  - The target Endevor stage Id/number.

#### options

- `--proc-group` | `--pg` (string)

  - The Endevor processor group you would like to use.

- `--element-version` | `--ev` (number)

  - Indicates the version number of the element (use along with the level option).

- `--level` | `--lev` (number)

  - Indicates the level number of the element (use along with the version option).

- `--new-version` | `--nv` (number)

  - Assign a different version number to the Element.

- `--sync` | `-s` (boolean)

  - Specify if you want to synchronize source and current level of the Elements while performing this action.

- `--with-history` | `--wh` (boolean)

  - Specify if you want to preserve the change history of the Elements while performing this action.

- `--ignore-generate-failed` | `--igf` (boolean)

  - Process the transfer request regardless of whether the FAILED flag is set for the element or if the element was generated or moved successfully.

- `--bypass-element-delete` | `--bed` (boolean)

  - Specify if you want to retain the Elements in the source Stage after successfully completing this action.

- `--bypass-delete-proc` | `--bdp` (boolean)

  - Specity to bypasses the execution of the delete processor.

- `--bypass-generate-proc` | `--bgp` (boolean)

  - Specify to bypasses the execution of the generate or move processor (whichever may be chosen) upon element transfer.

- `--retain-signout` | `--rs` (boolean)

  - Specify if you want to retain the source location signouts for all Elements at the target location while performing this action.

- `--signout-to` | `--st` (string)

  - Specify if you want to sign all Elements out to the specified user ID at the target Stage while performing this action.

- `--override-signout` | `--os` (boolean)

  - Specify if you want to override the Signout of an Endevor element while performing this action.

- `--where-proc-group` | `--wpg` (string)

  - Lets you select Elements according to a specified Processor group. You can use a wildcard when specifying the Processor group name.
    Accepts up to 8 Processor group names separated by ", ".

- `--where-ccid-all` | `--wca` (string)

  - Instructs Endevor to search both the Master Control File and the SOURCE DELTA levels for a specified CCIDs.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-current` | `--wcc` (string)

  - Instructs Endevor to search through the CCID fields in the Master Control File to find a specified CCIDs.
    Accept up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-retrieve` | `--wcr` (string)

  - Instructs Endevor to use the CCID in the Master Control File RETRIEVE CCID field.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Transfer element from specified inventory location to 1 stage higher in map, with endevor profile set up:

  - `zowe endevor transfer element elementName --env ENV --sn 1 --tosn 2 --sys SYS --sub SUB --typ TYPE -i ENDEVOR`

## zowe › endevor › unsynchronize

Remove a synchronized Endevor inventory from a local Endevor workspace and delete any related metadata.

### zowe › endevor › unsynchronize › workspace

Remove a selected subset of remote Endevor inventory from a local Endevor workspace

#### Usage

zowe endevor unsynchronize workspace [workspace-dir] [options]

#### Positional Arguments

- `workspace-dir` (string)

  - The Endevor workspace directory, if different from current working directory.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: \*, \%, 1, 2

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### workspace options

- `--element` | `--ele` | `--elem` (string)

  - Name filter to synchronize only specific Endevor element(s).

    Default value: *

- `--force` | `-f` (boolean)

  - Force unsynchronization of local workspace regardless of any local changes not yet saved into Endevor.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Remove all elements in the map location defined by the currently active endevor-location profile from current directory:

  - `zowe endevor unsynchronize workspace`

- Remove all elements in the map location defined by the currently active endevor-location profile from current directory, throwing away any local changes not saved in Endevor:

  - `zowe endevor unsynchronize workspace --force`

- Remove all elements in the map location defined by the currently active endevor-location profile from workspace directory 'C:/projects/myWorkspace':

  - `zowe endevor unsynchronize workspace 'C:/projects/myWorkspace'`

- Remove all elements in system SYSTEM1 subsystem SUBSYS1 environment DEV stage 1, whose type begins with 'ASM', from current directory:

  - `zowe endevor unsynchronize workspace --environment DEV --stage_number 1 --system SYSTEM1 --subsystem SUBSYS1 --type ASM* --ccid myccid --comment 'my changes'`

## zowe › endevor › update

Update an Element or a Package in Endevor.

### zowe › endevor › update › element

The update element command updates an Element in the entry Stage, thereby creating a new level for the Element in the entry Stage.

#### Usage

zowe endevor update element <element> [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element.

#### input sources options

- `--from-file` | `--ff` (string)

  - Use this input to provide source file.

- `--from-dataset` | `--fd` (string)

  - Use this input to provide source data set name.

- `--from-member` | `--fm` (string)

  - Use this input to provide source member name in the data set.

- `--from-path` | `--fp` (string)

  - Use this input to provide the path of source USS file. It must be used with from-uss-file.

- `--from-uss-file` | `--fuf` (string)

  - Use this input to provide source USS file name. It must be used with from-path

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--ccid` | `--cci` (string)

  - The CCID you want to use when performing an Element action.

- `--comment` | `--com` (string)

  - The comment you want to have when performing an Element action

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--override-signout` | `--os` (boolean)

  - Specify if you want to override the Signout of an Endevor element while performing this action.

- `--proc-group` | `--pg` (string)

  - The Endevor processor group you would like to use.

- `--generate` | `-g` (boolean)

  - Specifies if you want to Generate Element after Add/Update action.

- `--get-fingerprint` | `--gfg` (boolean)

  - Return fingerprint of a retrieved, added or updated element as the first line of the response.

    Default value: false

- `--fingerprint` | `--fg` (string)

  - Specifies the fingerprint of the element to Add or Update. Use value 'NEW' when adding a new element that shouldn't exist in the map yet.

- `--charset` | `--char` (string)

  - Specifies the clients preferred character set when retrieving, printing or updating elements.

    Default value: false

- `--sync` | `-s` (boolean)

  - Specify if you want to synchronize source and current level of the Elements while performing this action.

- `--sync-with-history` | `--swh` (boolean)

  - Specify if you want to preserve the change history of the Elements while performing the synchronization during element update.

- `--sync-fingerprint` | `--sfg` (string)

  - Specifies the fingerprint of the element directly up the map that the updated element should be synchronized with. Prevents the sync if the element up the map doesn't match the fingerprint.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Update element from local file with endevor profile set up:

  - `zowe endevor update element elementName --env ENV --sys SYS --sub SUB --typ TYPE --ff localfile.txt -i ENDEVOR --ccid CCID --comment 'updating element'`

### zowe › endevor › update › package

The update package command lets you update a package in Endevor.

#### Usage

zowe endevor update package [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### input sources options

- `--from-file` | `--ff` (string)

  - Use this input to provide source file.

- `--from-dataset` | `--fd` (string)

  - Use this input to provide source data set name.

- `--from-member` | `--fm` (string)

  - Use this input to provide source member name in the data set.

- `--from-package` | `--fp` (string)

  - Directs the Create/Update action to copy the SCL from the package you specify into the package you are creating or updating.

- `--from-text` | `--ft` (string)

  - Provides a string to use as input SCL.

#### options

- `--description` | `-d` (string)

  - Allows you to associate a 50-character description when creating or updating package.

- `--from-date-time` | `--fdt` (string)

  - Specify the beginning of time frame within which the package can be executed. Use yyyy-mm-ddThh:mm or see ISO 8601 standard for syntax.

- `--to-date-time` | `--tdt` (string)

  - Specify the end of time frame within which the package can be executed. Use yyyy-mm-ddThh:mm or see ISO 8601 standard for syntax.

- `--backout` (boolean)

  - Set this option to false (or specify --no-backout) if you don't want to have the backout facility available for this package. By default backout is enabled.

    Default value: true

- `--notes` | `-n` (string)

  - Notes for package.

- `--notes-from-file` | `--nff` (string)

  - Local file of notes for package.

- `--emergency-package` | `--ep` (boolean)

  - Specify if the package should be an emergency package. When not specified, the package is a standard package.

- `--sharable` | `--sh` (boolean)

  - Specify this option if the package can be edited by more than one person when in In-edit status.

- `--promotion` | `--pr` (boolean)

  - Specify this option to define the package as a promotion package.

- `--validate-scl` | `--vs` (boolean)

  - Set this option to false (or specify --no-validate-scl) to skip validion of the package components while creating a package. By default the SCL is validated

    Default value: true

- `--append` | `-a` (boolean)

  - Specify this option to append the SCL you are adding to the existing package SCL. Otherwise it would be replaced.

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### output customization options

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- Update package from local file with endevor profile set up:

  - `zowe endevor update package packageName --ff localfile.txt -i ENDEVOR`

## zowe › endevor › view

View an Element or a Package SCL in Endevor.

### zowe › endevor › view › element

The view element command views an existing element in Endevor.

#### Usage

zowe endevor view element <element> [options]

#### Positional Arguments

- `element` (string)

  - Name of the Endevor element.

#### endevor-location definition options

- `--environment` | `--env` (string)

  - The Endevor environment where your project resides.

- `--system` | `--sys` (string)

  - The Endevor system where your project resides.

- `--subsystem` | `--sub` (string)

  - The Endevor subsystem where your project resides.

- `--type` | `--typ` (string)

  - Name of the Endevor element's type.

- `--stage-number` | `--sn` (string)

  - The Endevor stage number where your project resides.

    Allowed values: 1, 2

- `--ccid` | `--cci` (string)

  - The CCID you want to use when performing an Element action.

- `--comment` | `--com` (string)

  - The comment you want to have when performing an Element action

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### options

- `--element-version` | `--ev` (number)

  - Indicates the version number of the element (use along with the level option).

- `--level` | `--lev` (number)

  - Indicates the level number of the element (use along with the version option).

- `--search` | `--sea` (boolean)

  - Enables the search through the Endevor map.

- `--where-ccid-all` | `--wca` (string)

  - Instructs Endevor to search both the Master Control File and the SOURCE DELTA levels for a specified CCIDs.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-current` | `--wcc` (string)

  - Instructs Endevor to search through the CCID fields in the Master Control File to find a specified CCIDs.
    Accept up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-ccid-retrieve` | `--wcr` (string)

  - Instructs Endevor to use the CCID in the Master Control File RETRIEVE CCID field.
    Accepts up to 8 CCIDs separated by ", ". Enclose CCIDs that contain special characters in quotes.

- `--where-proc-group` | `--wpg` (string)

  - Lets you select Elements according to a specified Processor group. You can use a wildcard when specifying the Processor group name.
    Accepts up to 8 Processor group names separated by ", ".

- `--charset` | `--char` (string)

  - Specifies the clients preferred character set when retrieving, printing or updating elements.

    Default value: false

#### output customization options

- `--to-file` | `--tf` (string)

  - The file name in which the data from the command output is stored

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### asynchronous task options

- `--asynchronous` | `--async` (boolean)

  - Submit this command as an asynchronous Endevor Web Services task

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- View element from specified inventory location to local file with endevor profile set up:

  - `zowe endevor view element elementName --env ENV --sn 1 --sys SYS --sub SUB --typ TYPE --tf localfile.txt -i ENDEVOR`

### zowe › endevor › view › pkgscl

The view pkgscl command views the SCL of an existing package in Endevor.

#### Usage

zowe endevor view pkgscl [package] [options]

#### Positional Arguments

- `package` (string)

  - Name of the Endevor package.

#### endevor-location definition options

- `--maxrc` (number)

  - The maximum value of the return code of a successful action. When the return code is greater than the maxrc value, the command fails

    Default value: 8

- `--instance` | `-i` (string)

  - Specifies Endevor Web Services dataSource name.

#### output customization options

- `--to-file` | `--tf` (string)

  - The file name in which the data from the command output is stored

- `--suppress-messages` | `--sm` (boolean)

  - Suppress all [INFO]/[WARN] messages from terminal output.

- `--report-file` | `--file-name` (string)

  - File name for saving reports from Endevor SCM locally.

- `--report-dir` (string)

  - Directory for saving reports from Endevor SCM locally, if --report-file wasn't specified. Defaults to current directory.

- `--write-report` (boolean)

  - Write the endevor reports to a file. By default, when return code is 0, no report will be written, unless this option is specified. When return code is bigger than 0, reports will be written to a file, unless this option is specifed to be false

#### endevor session definition options

- `--host` | `--hostname` (string)

  - Specifies the base host name.

- `--port` | `-p` (string)

  - Specifies the port number.

- `--protocol` | `--prot` (string)

  - Specifies the protocol used for connecting to Endevor Rest API

    Default value: https
    Allowed values: http, https

- `--user` | `--username` (string)

  - Specifies the user name.

- `--password` | `--pass` (string)

  - Specifies the user's password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Specify this option to have the server certificate verified against the list of supplied CAs

- `--base-path` | `--bp` (string)

  - Specifies the base path used for connecting to Endevor Rest API

#### Profile Options

- `--endevor-profile` | `--endevor-p` (string)

  - The name of a (endevor) profile to load for this command execution.

- `--endevor-location-profile` | `--endevor-location-p` (string)

  - The name of a (endevor-location) 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

- `--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

- View SCL of package "packageName" in the console with endevor profile set up:

  - `zowe endevor view pkgscl packageName -i ENDEVOR`

## zowe › file-master-plus

File Master Plus command line interface is a file management and data manipulation tool.
It speeds up file creation and manipulates virtual storage access method (VSAM), sequential and partitioned data sets.
It also supports symbolic access to data via layouts and data manipulation like selection of records in data sets.

## zowe › file-master-plus › copy

Copy data from a data set and optionally filter or modify the copied data by using selection criteria.

### zowe › file-master-plus › copy › data-set

Copy from a data set to another data set.
If the <to> data set does not exist, File Master Plus automatically creates a new data set using the attributes of <from> data set.
It supports all data set types that are supported by File Master Plus.

#### Usage

zowe file-master-plus copy data-set <from> <to> [options]

#### Positional Arguments

- `from` (string)

  - Specifies the name of the data set to copy from.

- `to` (string)

  - Specifies the name of the data set to copy to.

#### Options

- `--members` | `-m` (array)

  - Specifies the members that you want to copy from the data set. To rename the member, specify a new member name after the delimiter ','.If this parameter is not specified all the members are copied.
    Note: This parameter only applies to a PDS or PDSE.
    Example: --mem mem1,newmem1 mem2. Here 'mem2' is copied as it is, and 'mem1' is renamed as 'newmem1'.

- `--generation` | `-g` (string)

  - Specifies the PDSE V2 generation number that you want to copy from the data set from.
    Note: This parameter should only be specified if data set from is PDSEV2. If not specified and data set from is a PDSE V2 then current generation, i.e. generation 0, is copied. If generation is negative specifies Relative generation, positive specifies Absolute generation, * specifies all generations and 0 specifies current generation.
    Example1: --generation *. All generations of member(s) is copied.
    Example2: --generation -1. Relative generation -1 of member(s) is copied.
    Example3: --generation 4. Absolute generation 4 of member(s) is copied.
    Allowed values: '*','range from -2000000000 to 2000000000'

- `--replace` | `-r` (string)

  - Replace resource-specific items in the target data set. Note: Used only if the target data set is a PDS or a VSAM KSDS.
    Example: -r n.

    Default value: y
    Allowed values: y, n

- `--static-selection-criteria` | `--ssc` (string)

  - Specifies the name of pre-defined File Master Plus selection criteria. The name refers to a member in the defaultselection criteria data set as defined in the FMM_CLIST parameter in File Master Plus server.
    Example: --ssc testcri

- `--dynamic-selection-criteria` | `--dsc` (string)

  - Specifies path of the .txt file where the dynamic selection criteria exist. Ensure the format of the file is identical to the static selection criteria created by File Master Plus. If the selection criteria refer to field names in a Cobol or PL/I copybook, use the --layout-member and --layout-data-set parameters to name the copybook location.
    Example: --dsc ../selcri/testcri.txt

- `--layout-member` | `--lm` (string)

  - Specifies name of the Cobol or PL/I copybook.
    Example: -lm testlay.

- `--layout-data-set` | `--lds` (string)

  - Specifies name of the data set that contains the layout member.
    Example: -lds fmmvs.layout.dataset.

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Copying a data set:

  - `zowe file-master-plus copy data-set fmmvs.pds1 fmmvs.pds2`

- Copying a data set with dynamic selection criteria:

  - `zowe file-master-plus copy data-set fmmvs.from.ps fmmvs.to.ps --lds fmmvs.layout.dataset --lm testlay --dsc ./fmmvs/selcri/testcri`

- Copying a PDSE V2 data set with all generations:

  - `zowe file-master-plus copy data-set fmmvs.from.psdsev2 fmmvs.to.psdsev2 --generation *`

## zowe › file-master-plus › create

Create a data set.

### zowe › file-master-plus › create › large-format-sequential

Create a large format sequential data set.

#### Usage

zowe file-master-plus create large-format-sequential <name> [options]

#### Positional Arguments

- `name` (string)

  - Specifies the name of the data set to create.

#### Options

- `--model` | `-m` (string)

  - Specifies the name of a model large format sequential data set name for allocating parameters.
    The parameters of the model data set override all defaults.
    Example: -m fmmvs.model.dsname

- `--logical-record-length` | `--lrecl` | `--lrl` (number)

  - Specifies the length of the logical record.
    Allowed values: 1-32760
    Default value: 80
    Example: --lrecl 80

- `--block-size` | `--blksize` | `--bs` (number)

  - Specifies the size of the block of records.
    Allowed values: 1-32760
    Default value: 6160
    Example: --blksize 6160

- `--record-format` | `--recfm` | `--rf` (string)

  - Specifies the record format.
    The allowed values which have the following meaning:
    F - Fixed-length records
    V - Variable-length records
    U - Undefined-length records
    B - Records are blocked
    A - Records contain ASCII printer control characters
    M - Records contain machine code control characters
    S - For variable-length records, records may span blocks
    T - Records may be written into overflow tracks
    Default value: FB
    Example: --recfm FB

    Allowed values: F, FA, FM, FB, FBA, FBM, FS, FSA, FSM, FT, FTA, FTM, FBS, FBT, U, UA, UM, UT, UTA, UTM, V, VA, VM, VB, VBA, VBM, VS, VSA, VSM, VT, VTA, VTM, VBS, VBT

- `--space-units` | `--su` (string)

  - Specifies the space allocation unit.
    The allowed values which have the following meaning:
    TRK - Tracks
    CYL - Cylinders
    BLK - Blocksize
    Default value: CYL
    Example: --su blk

    Allowed values: TRK, CYL, BLK

- `--primary-space` | `--ps` (number)

  - Specifies primary space allocation unit.
    Allowed values: 1-16777215
    Default value: 1
    Example: --ps 3

- `--secondary-space` | `--ss` (number)

  - Specifies secondary space allocation unit.
    Allowed values: 1-16777215
    Default value: 1
    Example: --ss 5

- `--volume` | `-v` (array)

  - Specifies a disk volume or specific tapes.
    Example: -v vol002

- `--unit-type` | `--ut` (string)

  - Specifies the DASD unit name.
    Example: --ut sysda

- `--expiration-date` | `--ed` (string)

  - Specifies the expiration date after which the data set can be deleted.
    Specify 'P' or 'p' to make the data set permanent, or an expiration date in YYYY-MM-DD format.
    Example: --ed 2032-07-31

- `--storage-class` | `--sc` (string)

  - Specifies the storage class.
    Example: --sc scl002

- `--management-class` | `--mc` (string)

  - Specifies the management class.
    Example: --mc mcl002

- `--data-class` | `--dc` (string)

  - Specifies the data class.
    Example: --dc dcl002

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Creating a large format sequential data set with default option values:

  - `zowe file-master-plus create large-format-sequential fmmvs.test.dsname`

- Creating a large format sequential data set with options:

  - `zowe file-master-plus create large-format-sequential fmmvs.test.dsname --lrecl 180 --blksize 32720 --recfm vb --ps 5 --ss 5 -v vol005 --su trk --ed 2025-09-27`

- Creating a large format sequential data set like a model large format sequential data set:

  - `zowe file-master-plus create large-format-sequential fmmvs.test.dsname --model fmmvs.model.dsname`

- Creating a large format sequential data set like a model large format sequential data set and overriding the parameters with options:

  - `zowe file-master-plus create large-format-sequential fmmvs.test.dsname --model fmmvs.model.dsname --lrecl 180 --recfm VB --ps 5 --ss 5 --ed p`

### zowe › file-master-plus › create › like-model

Create a data set by allocating parameters from a model data set.

#### Usage

zowe file-master-plus create like-model <name> <model> [options]

#### Positional Arguments

- `name` (string)

  - Specifies the name of the data set to create.

- `model` (string)

  - Specifies the name of the model data set.

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Creating a data set like a model data set:

  - `zowe file-master-plus create like-model fmmvs.create.dsname fmmvs.model.dsname`

### zowe › file-master-plus › create › partitioned-data-set

Create a partitioned data set.

#### Usage

zowe file-master-plus create partitioned-data-set <name> [options]

#### Positional Arguments

- `name` (string)

  - Specifies the name of the data set to create.

#### Options

- `--model` | `-m` (string)

  - Specifies the name of a model partitioned data set for allocating parameters.
    The parameters of the model data set override all defaults.
    Example: -m fmmvs.model.dsname

- `--logical-record-length` | `--lrecl` | `--lrl` (number)

  - Specifies the length of the logical record.
    Allowed values: 1-32760
    Default value: 80
    Example: --lrecl 80

- `--block-size` | `--blksize` | `--bs` (number)

  - Specifies the size of the block of records.
    Allowed values: 1-32760
    Default value: 6160
    Example: --blksize 6160

- `--record-format` | `--recfm` | `--rf` (string)

  - Specifies the record format.
    The allowed values have the following meaning:
    F - Fixed-length records
    V - Variable-length records
    U - Undefined-length records
    B - Records are blocked
    A - Records contain ASCII printer control characters
    M - Records contain machine code control characters
    S - For variable-length records, records may span blocks
    T - Records may be written into overflow tracks
    Default value: FB
    Example: --recfm FB

    Allowed values: F, FA, FM, FB, FBA, FBM, FS, FSA, FSM, FT, FTA, FTM, FBS, FBT, U, UA, UM, UT, UTA, UTM, V, VA, VM, VB, VBA, VBM, VS, VSA, VSM, VT, VTA, VTM, VBS, VBT

- `--space-units` | `--su` (string)

  - Specifies the space allocation unit.
    The allowed values which have the following meaning:
    TRK - Tracks
    CYL - Cylinders
    BLK - Blocksize
    Default value: CYL
    Example: --su blk

    Allowed values: TRK, CYL, BLK

- `--primary-space` | `--ps` (number)

  - Specifies the primary space allocation unit.
    Allowed values: 1-16777215
    Default value: 1
    Example: --ps 3

- `--secondary-space` | `--ss` (number)

  - Specifies the secondary space allocation unit.
    Allowed values: 1-16777215
    Default value: 1
    Example: --ss 5

- `--directory-blocks` | `--db` (number)

  - Specifies number of directory blocks.
    Allowed values: 1-16777215
    Default value: 5
    Example: --db 5

- `--volume` | `-v` (string)

  - Specifies a disk volume or specific tapes.
    Example: -v vol002

- `--unit-type` | `--ut` (string)

  - Specifies the DASD unit name.
    Example: --ut sysda

- `--expiration-date` | `--ed` (string)

  - Specifies the expiration date after which the data set can be deleted.
    Specify 'P' or 'p' to make the data set permanent, or an expiration date in YYYY-MM-DD format.
    Example: --ed 2032-07-31

- `--storage-class` | `--sc` (string)

  - Specifies the storage class.
    Example: --sc scl002

- `--management-class` | `--mc` (string)

  - Specifies the management class.
    Example: --mc mcl002

- `--data-class` | `--dc` (string)

  - Specifies the data class.
    Example: --dc dcl002

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Creating a PDS with default option values:

  - `zowe file-master-plus create partitioned-data-set fmmvs.test.dsname`

- Creating a PDS with options:

  - `zowe file-master-plus create partitioned-data-set fmmvs.test.dsname --lrecl 180 --blksize 32720 --recfm vb --ps 5 --ss 5 --db 5 -v vol005 --su trk --ed p`

- Creating a PDS like a model PDS:

  - `zowe file-master-plus create partitioned-data-set fmmvs.test.dsname --model fmmvs.model.dsname`

- Creating a PDS like a model PDS and overriding the parameters with options:

  - `zowe file-master-plus create partitioned-data-set fmmvs.test.dsname --model fmmvs.model.dsname --lrecl 180 --recfm vb --ps 5 --ss 5 --db 5 -v vol005 --ed 2025-09-27`

### zowe › file-master-plus › create › partitioned-data-set-extended

Create an extended partitioned data set.

#### Usage

zowe file-master-plus create partitioned-data-set-extended <name> [options]

#### Positional Arguments

- `name` (string)

  - Specifies the name of the data set to create.

#### Options

- `--model` | `-m` (string)

  - Specifies the name of a model extentded partitioned data set name for allocating parameters.
    The parameters of the model data set override all defaults.
    Example: -m fmmvs.model.dsname

- `--data-set-version` | `--dsv` | `--ver` (number)

  - Specifies the data set version.
    Default value depends on the system settings.
    Example: --ver 2

    Allowed values: 1, 2

- `--generations` | `-g` (number)

  - Specifies the number of generations.
    Applicable when data set version is '2'.
    Default value: 0
    Example: -g 10

- `--logical-record-length` | `--lrecl` | `--lrl` (number)

  - Specifies the length of the logical record.
    Allowed values: 1-32760
    Default value: 80
    Example: --lrecl 80

- `--block-size` | `--blksize` | `--bs` (number)

  - Specifies the size of the block of records.
    Allowed values: 1-32760
    Default value: 6160
    Example: --blksize 6160

- `--record-format` | `--recfm` | `--rf` (string)

  - Specifies the record format.
    The allowed values which have the following meaning:
    F - Fixed-length records
    V - Variable-length records
    U - Undefined-length records
    B - Records are blocked
    A - Records contain ASCII printer control characters
    M - Records contain machine code control characters
    S - For variable-length records, records may span blocks
    T - Records may be written into overflow tracks
    Default value: FB
    Example: --recfm FB

    Allowed values: F, FA, FM, FB, FBA, FBM, FS, FSA, FSM, FT, FTA, FTM, FBS, FBT, U, UA, UM, UT, UTA, UTM, V, VA, VM, VB, VBA, VBM, VS, VSA, VSM, VT, VTA, VTM, VBS, VBT

- `--space-units` | `--su` (string)

  - Specifies the space allocation unit.
    The allowed values have the following meaning:
    TRK - Tracks
    CYL - Cylinders
    BLK - Blocksize
    Default value: CYL
    Example: --su blk

    Allowed values: TRK, CYL, BLK

- `--primary-space` | `--ps` (number)

  - Specifies primary space allocation unit.
    Allowed values: 1-16777215
    Default value: 1
    Example: --ps 3

- `--secondary-space` | `--ss` (number)

  - Specifies secondary space allocation unit.
    Allowed values: 1-16777215
    Default value: 1
    Example: --ss 5

- `--volume` | `-v` (string)

  - Specifies a disk volume or specific tapes.
    Example: -v vol002

- `--unit-type` | `--ut` (string)

  - Specifies the DASD unit name.
    Example: --ut sysda

- `--expiration-date` | `--ed` (string)

  - Specifies the expiration date after which the data set can be deleted.
    Specify 'P' or 'p' to make the data set permanent, or an expiration date in YYYY-MM-DD format.
    Example: --ed 2032-07-31

- `--storage-class` | `--sc` (string)

  - Specifies the storage class.
    Example: --sc scl002

- `--management-class` | `--mc` (string)

  - Specifies the management class.
    Example: --mc mcl002

- `--data-class` | `--dc` (string)

  - Specifies the data class.
    Example: --dc dcl002

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Creating a PDSE with default option values:

  - `zowe file-master-plus create partitioned-data-set-extended fmmvs.test.dsname`

- Creating a PDSE version 2 with options:

  - `zowe file-master-plus create partitioned-data-set-extended fmmvs.test.dsname --ver 2 -g 10 --lrecl 180 --blksize 32720 --recfm vb --ps 5 --ss 5 -v vol005 --su trk --ed 2025-09-27`

- Creating a PDSE data set like a model PDSE:

  - `zowe file-master-plus create partitioned-data-set-extended fmmvs.test.dsname --model fmmvs.model.dsname`

- Creating a PDSE like a model PDSE and the parameters with options:

  - `zowe file-master-plus create partitioned-data-set-extended fmmvs.test.dsname --model fmmvs.model.dsname --lrecl 180 --recfm vb --ps 5 --ss 5 --db 5 -v vol005 --ed p`

### zowe › file-master-plus › create › physical-sequential

Create a physical sequential data set.

#### Usage

zowe file-master-plus create physical-sequential <name> [options]

#### Positional Arguments

- `name` (string)

  - Specifies the name of the data set to create.

#### Options

- `--model` | `-m` (string)

  - Specifies the name of a model physical sequential data set name for allocating parameters.
    The parameters of the model data set override all defaults.
    Example: -m fmmvs.model.dsname

- `--logical-record-length` | `--lrecl` | `--lrl` (number)

  - Specifies the length of the logical record.
    Allowed values: 1-32760
    Default value: 80
    Example: --lrecl 80

- `--block-size` | `--blksize` | `--bs` (number)

  - Specifies the size of the block of records.
    Allowed values: 1-32760
    Default value: 6160
    Example: --blksize 6160

- `--record-format` | `--recfm` | `--rf` (string)

  - Specifies the record format.
    The allowed values which have the following meaning:
    F - Fixed-length records
    V - Variable-length records
    U - Undefined-length records
    B - Records are blocked
    A - Records contain ASCII printer control characters
    M - Records contain machine code control characters
    S - For variable-length records, records may span blocks
    T - Records may be written into overflow tracks
    Default value: FB
    Example: --recfm FB

    Allowed values: F, FA, FM, FB, FBA, FBM, FS, FSA, FSM, FT, FTA, FTM, FBS, FBT, U, UA, UM, UT, UTA, UTM, V, VA, VM, VB, VBA, VBM, VS, VSA, VSM, VT, VTA, VTM, VBS, VBT

- `--space-units` | `--su` (string)

  - Specifies the space allocation unit.
    The allowed values which have the following meaning:
    TRK - Tracks
    CYL - Cylinders
    BLK - Blocksize
    Default value: CYL
    Example: --su blk

    Allowed values: TRK, CYL, BLK

- `--primary-space` | `--ps` (number)

  - Specifies primary space allocation unit.
    Allowed values: 1-16777215
    Default value: 1
    Example: --ps 3

- `--secondary-space` | `--ss` (number)

  - Specifies secondary space allocation unit.
    Allowed values: 1-16777215
    Default value: 1
    Example: --ss 5

- `--volume` | `-v` (array)

  - Specifies a disk volume or specific tapes.
    Example: -v vol002

- `--unit-type` | `--ut` (string)

  - Specifies the DASD unit name.
    Example: --ut sysda

- `--expiration-date` | `--ed` (string)

  - Specifies the expiration date after which the data set can be deleted.
    Specify 'P' or 'p' to make the data set permanent, or an expiration date in YYYY-MM-DD format.
    Example: --ed 2032-07-31

- `--storage-class` | `--sc` (string)

  - Specifies the storage class.
    Example: --sc scl002

- `--management-class` | `--mc` (string)

  - Specifies the management class.
    Example: --mc mcl002

- `--data-class` | `--dc` (string)

  - Specifies the data class.
    Example: --dc dcl002

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Creating a physical sequential data set with default option values:

  - `zowe file-master-plus create physical-sequential fmmvs.test.dsname`

- Creating a physical sequential data set with options:

  - `zowe file-master-plus create physical-sequential fmmvs.test.dsname --lrecl 180 --blksize 32720 --recfm vb --ps 5 --ss 5 -v vol005 --su trk --ed 2025-09-27`

- Creating a physical sequential data set like a model physical sequential data set:

  - `zowe file-master-plus create physical-sequential fmmvs.test.dsname --model fmmvs.model.dsname`

- Creating a physical sequential data set like a model physical sequential data set and overriding the parameters with options:

  - `zowe file-master-plus create physical-sequential fmmvs.test.dsname --model fmmvs.model.dsname --lrecl 180 --recfm VB --ps 5 --ss 5 --ed p`

### zowe › file-master-plus › create › vsam-esds

Create an entry-sequenced Virtual Storage Access Method (VSAM) data set (ESDS).

#### Usage

zowe file-master-plus create vsam-esds <name> [options]

#### Positional Arguments

- `name` (string)

  - Specifies the name of the data set to create.

#### Options

- `--model` | `-m` (string)

  - Specifies the name of a ESDS (entry-sequenced VSAM data set) for allocating parameters.
    The parameters of the model data set override all defaults.
    Example: -m fmmvs.model.dsname

- `--maximum-record-size` | `--mrs` (number)

  - Specifies the maximum length of data records.
    This parameter is mandatory unless a model data set is specified.
    Example: --mrs 180

- `--average-record-size` | `--ars` (number)

  - Specifies the average length of data records.
    If this parameter is not specified then it is set to the same as the maximum-record-size option.
    Example: --ars 110

- `--data-dsname` | `--ddsn` (string)

  - Specifies the data set name of the data VSAM component.
    If this parameter is not specified then by default it is set to the cluster name with ‘.DATA’.
    Example: --ddsn fmmvs.vsam.esds.data

- `--data-control-interval-size` | `--dcis` (number)

  - Specifies the size of the Control Interval for the data VSAM component.
    Default value: 20480
    Example: --dcis 3584

- `--data-space-units` | `--dsu` (string)

  - Specifies the space allocation unit for data vsam component.
    The allowed values have the following meaning:
    TRK - Tracks
    CYL - Cylinders
    REC - Records
    K - Kilobytes
    M - Megabytes
    Default value: TRK
    Example: --dsu rec

    Allowed values: TRK, CYL, REC, K, M

- `--data-primary-space` | `--dps` (number)

  - Specifies the primary space allocation unit for the data VSAM component.
    Allowed values: 1-16777215
    Default value: 18
    Example: --dps 3

- `--data-secondary-space` | `--dss` (number)

  - Specifies the secondary space allocation unit for the data VSAM component.
    Allowed values: 1-16777215
    Default value: 3
    Example: --dss 5

- `--data-volume` | `--dv` (array)

  - Specifies a disk volume or specific tapes for the data VSAM component.
    Example: -dv vol002

- `--buffer-space` | `--bs` (number)

  - Specifies the minimum buffer space to allocate when this VSAM file is accessed.
    Example: --bs 37376

- `--erase` | `-e` (string)

  - Indicates whether the VSAM file was allocated with the ERASE parameter, causing all components of the file to be overwritten with binary zeros, when the VSAM file is deleted from the catalog.
    Default value: n
    Example: -e y

    Allowed values: y, n

- `--load-restartable` | `--lr` (string)

  - Specify 'Y' to request that the VSAM component definition use the 'RECOVERY' parameter (which causes the data component to be preformatted previous to the initial load). Using this option causes the initial load to take longer, but loads which do not complete successfully can be restarted.
    Specify 'N' to request that the VSAM component definition use the 'SPEED' parameter (which causes the data component to NOT be preformatted previous to the initial load).
    Default value: n
    Example: -lr y

    Allowed values: y, n

- `--reuse` | `-r` (string)

  - Indicates whether the VSAM file was allocated with the REUSE parameter specifying that the cluster can be opened again and again as a reusable cluster.
    Default value: n
    Example: -r y

    Allowed values: y, n

- `--spanned` | `-s` (string)

  - Indicates whether VSAM file was allocated with the SPANNED parameter indicating that data records larger than a control interval can span multiple control intervals.
    Default value: n
    Example: -s y

    Allowed values: y, n

- `--write-check` | `--wc` (string)

  - Indicates whether the VSAM file was allocated with the WRITECHECK parameter requesting each write to the VSAM file to be validated by a read without data transfer.
    Default value: n
    Example: --wc y

    Allowed values: y, n

- `--control-interval-freespace-percentage` | `--cifp` (number)

  - Specifies the percentage of empty space in each control interval when the file is initially loaded.The free space lets records be inserted or expanded within a control interval before requiring a control interval split.
    Example: --cifp 10

- `--control-area-freespace-percentage` | `--cafp` (number)

  - Specifies the percentage of control intervals to be left unused in each control area as the file is initially loaded. The use of control area free space lets some control interval splits occur before requiring a control area split.
    Example: --cafp 10

- `--cross-region-share-option` | `--crso` (number)

  - Specifies that the file can be shared among regions within the same system or within multiple systems using GRS (Global Resource Serialization).
    The allowed values have the following meaning:
    1 - The data set can be opened for read processing by an unlimited number of users, but the data set can be accessed by only one user when that user is doing read and write processing.
    2 - The data set can be opened by only one user at a time for read and write processing, but any number of users can also be accessing the data set for read processing
    3 - The data set can be fully shared by any number of users.
    4 - The data set can be fully shared by any number of users. VSAM immediately updates the data set for PUTs and refreshes all input buffers for GETs.
    Default value: 1
    Example: --crso 2

    Allowed values: 1, 2, 3, 4

- `--cross-system-share-option` | `--csso` (number)

  - Specifies how the file can be shared among systems.
    The allowed values have the following meaning:
    3 - The data set can be fully shared by any number of users.
    4 - The data set can be fully shared by any number of users. VSAM immediately updates the data set for PUTs and refreshes all input buffers for GETs.
    Default value: 3
    Example: --csso 4

    Allowed values: 3, 4

- `--expiration-date` | `--ed` (string)

  - Specifies the expiration date after which the data set can be deleted.
    Specify 'P' or 'p' to make the data set permanent, or an expiration date in YYYY-MM-DD format.
    Example: --ed 2032-07-31

- `--storage-class` | `--sc` (string)

  - Specifies the storage class.
    Example: --sc scl002

- `--management-class` | `--mc` (string)

  - Specifies the management class.
    Example: --mc mcl002

- `--data-class` | `--dc` (string)

  - Specifies the data class.
    Example: --dc dcl002

- `--log` | `-l` (string)

  - When specified, 'ALL' or 'UNDO' or 'NONE' indicates the VSAM RLS recovery option.
    Example: --log ALL

    Allowed values: NONE, UNDO, ALL

- `--frlog` | `--fr` (string)

  - Specifies the type of VSAM batch logging to perform for this VSAM data set.
    The allowed values have the following meaning:
    NONE - Disables VSAM batch logging.
    REDO - Enables VSAM batch logging.
    UNDO - Changes made to your VSAM data set are backed out using VSAM batch logging.
    ALL - Changes made to your VSAM data set are backed out and forward recovered using VSAM batch logging.
    Example: --frlog ALL

    Allowed values: NONE, UNDO, ALL, REDO

- `--log-replicate` | `--lrp` (string)

  - Specify 'Y' to enable VSAM replication for this data set.
    Example: --lrp y

    Allowed values: Y, N

- `--log-stream-id` | `--lsi` (string)

  - Specifies the 1- to 26-character name of the forward recovery log stream.
    Example: --lsi LOGSTRA

- `--rls-enable` | `--rls` | `--re` (string)

  - Specify 'N' to disable VSAM record-level sharing.
    Default value: y
    Example: --rls n

    Allowed values: Y, N

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Creating a ESDS with default option values and mandatory options:

  - `zowe file-master-plus create vsam-esds fmmvs.test.dsname --mrs 160`

- Creating a ESDS with options:

  - `zowe file-master-plus create vsam-esds fmmvs.test.dsname --mrs 160 --ars 120 --dcis 3584 --dsu cyl --dps 1 --dss 3 --dv vol002 --bs 37376 -e y -r y -s n --ed 2025-09-27`

- Creating a RLS enabled ESDS with logging options:

  - `zowe file-master-plus create vsam-esds fmmvs.test.dsname --mrs 160 --ars 120 --dcis 3584 --dsu cyl --dps 1 --dss 3 --dv vol002 --bs 37376 -e y -r y -s n --rls y -l all --lsi loga --lrp y --fr ALL`

- Creating a ESDS data set like a model ESDS data set:

  - `zowe file-master-plus create vsam-esds fmmvs.test.dsname --model fmmvs.model.dsname`

- Creating a ESDS like a model ESDS data set and overriding the parameters with options:

  - `zowe file-master-plus create vsam-esds fmmvs.test.dsname --model fmmvs.model.dsname --mrs 160 --wc y --bs 37376 --crso 3 --csso 4 --ed p`

### zowe › file-master-plus › create › vsam-ksds

Create a key-sequenced data set (KSDS) Virtual Storage Access Method (VSAM) data set.

#### Usage

zowe file-master-plus create vsam-ksds <name> [options]

#### Positional Arguments

- `name` (string)

  - Specifies the name of the data set to create.

#### Options

- `--model` | `-m` (string)

  - Specifies the name of a model KSDS (key-sequenced VSAM data set) for allocating parameters.
    The parameters of the model data set override all defaults.
    Example: -m fmmvs.model.dsname

- `--keys-position` | `--kp` (number)

  - Specifies the position of the key within the base cluster.
    This parameter is mandatory unless a model data set is specified.
    Example: --kp 1

- `--keys-length` | `--kl` (number)

  - Specifies the length of the key within the base cluster.
    This parameter is mandatory unless a model data set is specified.
    Example: --kl 7

- `--maximum-record-size` | `--mrs` (number)

  - Specifies the maximum length of data records.
    This parameter is mandatory unless a model data set is specified.
    Example: --mrs 180

- `--average-record-size` | `--ars` (number)

  - Specifies the average length of data records.
    If this parameter is not specified then it is set to the same as the maximum-record-size option.
    Example: --ars 110

- `--data-dsname` | `--ddsn` (string)

  - Specifies the data set name of the data VSAM component.
    If this parameter is not specified then by default it is set to the cluster name with ‘.DATA’.
    Example: --ddsn fmmvs.vsam.ksds.data

- `--data-control-interval-size` | `--dcis` (number)

  - Specifies the size of the Control Interval for the data VSAM component.
    Default value: 20480
    Example: --dcis 3584

- `--data-space-units` | `--dsu` (string)

  - Specifies the space allocation unit for data vsam component.
    The allowed values have the following meaning:
    TRK - Tracks
    CYL - Cylinders
    REC - Records
    K - Kilobytes
    M - Megabytes
    Default value: TRK
    Example: --dsu rec

    Allowed values: TRK, CYL, REC, K, M

- `--data-primary-space` | `--dps` (number)

  - Specifies the primary space allocation unit for the data VSAM component.
    Allowed values: 1-16777215
    Default value: 18
    Example: --dps 3

- `--data-secondary-space` | `--dss` (number)

  - Specifies the secondary space allocation unit for the data VSAM component.
    Allowed values: 1-16777215
    Default value: 3
    Example: --dss 5

- `--data-volume` | `--dv` (array)

  - Specifies a disk volume or specific tapes for the data VSAM component.
    Example: -dv vol002

- `--index-dsname` | `--idsn` (string)

  - Specifies the data set name of the index VSAM component.
    If this parameter is not specified then it is set to the cluster name with ‘.INDEX’ appended.
    Example: --ddsn fmmvs.vsam.ksds.index

- `--index-control-interval-size` | `--icis` (number)

  - Specifies the size of Control Interval for index VSAM component.
    Default value: 512
    Example: --icis 3584

- `--index-space-units` | `--isu` (string)

  - Specifies the space allocation unit for index VSAM component.
    The allowed values have the following meaning:
    TRK - Tracks
    CYL - Cylinders
    REC - Records
    K - Kilobytes
    M - Megabytes
    Default value: TRK
    Example: --isu cyl

    Allowed values: TRK, CYL, REC, K, M

- `--index-primary-space` | `--ips` (number)

  - Specifies primary space allocation unit for index VSAM component.
    Allowed values: 1-16777215
    Default value: 1
    Example: --ips 3

- `--index-secondary-space` | `--iss` (number)

  - Specifies secondary space allocation unit for index VSAM component.
    Allowed values: 1-16777215
    Default value: 1
    Example: --iss 5

- `--index-volume` | `--iv` (array)

  - Specifies a disk volume or specific tapes for the index VSAM component.
    Example: -iv vol002

- `--buffer-space` | `--bs` (number)

  - Specifies the minimum buffer space to allocate when this VSAM file is accessed.
    Example: --bs 37376

- `--erase` | `-e` (string)

  - Indicates whether the VSAM file was allocated with the ERASE parameter, causing all components of the file to be overwritten with binary zeros, when the VSAM file is deleted from the catalog.
    Default value: n
    Example: -e y

    Allowed values: y, n

- `--load-restartable` | `--lr` (string)

  - Specify 'Y' to request that the VSAM component definition use the 'RECOVERY' parameter (which causes the data component to be preformatted previous to the initial load). Using this option causes the initial load to take longer, but loads which do not complete successfully can be restarted.
    Specify 'N' to request that the VSAM component definition use the 'SPEED' parameter (which causes the data component to NOT be preformatted previous to the initial load).
    Default value: n
    Example: -lr y

    Allowed values: y, n

- `--reuse` | `-r` (string)

  - Indicates whether the VSAM file was allocated with the REUSE parameter specifying that the cluster can be opened again and again as a reusable cluster.
    Default value: n
    Example: -r y

    Allowed values: y, n

- `--spanned` | `-s` (string)

  - Indicates whether VSAM file was allocated with the SPANNED parameter indicating that data records larger than a control interval can span multiple control intervals.
    Default value: n
    Example: -s y

    Allowed values: y, n

- `--write-check` | `--wc` (string)

  - Indicates whether the VSAM file was allocated with the WRITECHECK parameter requesting each write to the VSAM file to be validated by a read without data transfer.
    Default value: n
    Example: --wc y

    Allowed values: y, n

- `--control-interval-freespace-percentage` | `--cifp` (number)

  - Specifies the percentage of empty space in each control interval when the file is initially loaded.The free space lets records be inserted or expanded within a control interval before requiring a control interval split.
    Example: --cifp 10

- `--control-area-freespace-percentage` | `--cafp` (number)

  - Specifies the percentage of control intervals to be left unused in each control area as the file is initially loaded. The use of control area free space lets some control interval splits occur before requiring a control area split.
    Example: --cafp 10

- `--cross-region-share-option` | `--crso` (number)

  - Specifies that the file can be shared among regions within the same system or within multiple systems using GRS (Global Resource Serialization).
    The allowed values have the following meaning:
    1 - The data set can be opened for read processing by an unlimited number of users, but the data set can be accessed by only one user when that user is doing read and write processing.
    2 - The data set can be opened by only one user at a time for read and write processing, but any number of users can also be accessing the data set for read processing
    3 - The data set can be fully shared by any number of users.
    4 - The data set can be fully shared by any number of users. VSAM immediately updates the data set for PUTs and refreshes all input buffers for GETs.
    Default value: 1
    Example: --crso 2

    Allowed values: 1, 2, 3, 4

- `--cross-system-share-option` | `--csso` (number)

  - Specifies how the file can be shared among systems.
    The allowed values have the following meaning:
    3 - The data set can be fully shared by any number of users.
    4 - The data set can be fully shared by any number of users. VSAM immediately updates the data set for PUTs and refreshes all input buffers for GETs.
    Default value: 3
    Example: --csso 4

    Allowed values: 3, 4

- `--expiration-date` | `--ed` (string)

  - Specifies the expiration date after which the data set can be deleted.
    Specify 'P' or 'p' to make the data set permanent, or an expiration date in YYYY-MM-DD format.
    Example: --ed 2032-07-31

- `--storage-class` | `--sc` (string)

  - Specifies the storage class.
    Example: --sc scl002

- `--management-class` | `--mc` (string)

  - Specifies the management class.
    Example: --mc mcl002

- `--data-class` | `--dc` (string)

  - Specifies the data class.
    Example: --dc dcl002

- `--log` | `-l` (string)

  - When specified, 'ALL' or 'UNDO' or 'NONE' indicates the VSAM RLS recovery option.
    Example: --log ALL

    Allowed values: NONE, UNDO, ALL

- `--frlog` | `--fr` (string)

  - Specifies the type of VSAM batch logging to perform for this VSAM data set.
    The allowed values have the following meaning:
    NONE - Disables VSAM batch logging.
    REDO - Enables VSAM batch logging.
    UNDO - Changes made to your VSAM data set are backed out using VSAM batch logging.
    ALL - Changes made to your VSAM data set are backed out and forward recovered using VSAM batch logging.
    Example: --frlog ALL

    Allowed values: NONE, UNDO, ALL, REDO

- `--log-replicate` | `--lrp` (string)

  - Specify 'Y' to enable VSAM replication for this data set.
    Example: --lrp y

    Allowed values: Y, N

- `--log-stream-id` | `--lsi` (string)

  - Specifies the 1- to 26-character name of the forward recovery log stream.
    Example: --lsi LOGSTRA

- `--rls-enable` | `--rls` | `--re` (string)

  - Specify 'N' to disable VSAM record-level sharing.
    Default value: y
    Example: --rls n

    Allowed values: Y, N

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Creating a KSDS with default option values and mandatory options:

  - `zowe file-master-plus create vsam-ksds fmmvs.test.dsname --kp 1 --kl 7 --mrs 160`

- Creating a KSDS with options:

  - `zowe file-master-plus create vsam-ksds fmmvs.test.dsname --kp 1 --kl 7 --mrs 160 --ars 120 --dcis 3584 --dsu cyl --dps 1 --dss 3 --dv vol002 --icis 512 --isu cyl --ips 1 --iss 1 --iv vol002 --bs 37376 -e y -r y -s n --ed 2025-09-27`

- Creating a RLS enabled KSDS with logging options:

  - `zowe file-master-plus create vsam-ksds fmmvs.test.dsname --kp 1 --kl 7 --mrs 160 --ars 120 --dcis 3584 --dsu cyl --dps 1 --dss 3 --dv vol002 --icis 512 --isu cyl --ips 1 --iss 1 --iv vol002 --bs 37376 -e y -r y -s n --rls y -l all --lsi loga --lrp y --fr ALL`

- Creating a KSDS data set like a model KSDS data set:

  - `zowe file-master-plus create vsam-ksds fmmvs.test.dsname --model fmmvs.model.dsname`

- Creating a KSDS like a model KSDS data set and overriding the parameters with options:

  - `zowe file-master-plus create vsam-ksds fmmvs.test.dsname --model fmmvs.model.dsname --kp 1 --kl 7 --mrs 160 --wc y --bs 37376 --crso 3 --csso 4 --ed p`

### zowe › file-master-plus › create › vsam-lds

Create linear data set (LDS) Virtual Storage Access Method (VSAM) data set.

#### Usage

zowe file-master-plus create vsam-lds <name> [options]

#### Positional Arguments

- `name` (string)

  - Specifies the name of the data set to create.

#### Options

- `--model` | `-m` (string)

  - Specifies the name of a model LDS (Linear VSAM data set) for allocating parameters.
    The parameters of the model data set override all defaults.
    Example: -m fmmvs.model.dsname

- `--data-dsname` | `--ddsn` (string)

  - Specifies the data set name of the data VSAM component.
    If this parameter is not specified then by default it is set to the cluster name with ‘.DATA’.
    Example: --ddsn fmmvs.vsam.esds.data

- `--data-control-interval-size` | `--dcis` (number)

  - Specifies the size of the Control Interval for the data VSAM component.
    Default value: 4096
    Example: --dcis 3584

- `--data-space-units` | `--dsu` (string)

  - Specifies the space allocation unit for data vsam component.
    The allowed values have the following meaning:
    TRK - Tracks
    CYL - Cylinders
    REC - Records
    K - Kilobytes
    M - Megabytes
    Default value: TRK
    Example: --dsu rec

    Allowed values: TRK, CYL, REC, K, M

- `--data-primary-space` | `--dps` (number)

  - Specifies the primary space allocation unit for the data VSAM component.
    Allowed values: 1-16777215
    Default value: 18
    Example: --dps 3

- `--data-secondary-space` | `--dss` (number)

  - Specifies the secondary space allocation unit for the data VSAM component.
    Allowed values: 1-16777215
    Default value: 3
    Example: --dss 5

- `--data-volume` | `--dv` (array)

  - Specifies a disk volume or specific tapes for the data VSAM component.
    Example: -dv vol002

- `--buffer-space` | `--bs` (number)

  - Specifies the minimum buffer space to allocate when this VSAM file is accessed.
    Example: --bs 37376

- `--erase` | `-e` (string)

  - Indicates whether the VSAM file was allocated with the ERASE parameter, causing all components of the file to be overwritten with binary zeros, when the VSAM file is deleted from the catalog.
    Default value: n
    Example: -e y

    Allowed values: y, n

- `--load-restartable` | `--lr` (string)

  - Specify 'Y' to request that the VSAM component definition use the 'RECOVERY' parameter (which causes the data component to be preformatted previous to the initial load). Using this option causes the initial load to take longer, but loads which do not complete successfully can be restarted.
    Specify 'N' to request that the VSAM component definition use the 'SPEED' parameter (which causes the data component to NOT be preformatted previous to the initial load).
    Default value: n
    Example: -lr y

    Allowed values: y, n

- `--reuse` | `-r` (string)

  - Indicates whether the VSAM file was allocated with the REUSE parameter specifying that the cluster can be opened again and again as a reusable cluster.
    Default value: n
    Example: -r y

    Allowed values: y, n

- `--write-check` | `--wc` (string)

  - Indicates whether the VSAM file was allocated with the WRITECHECK parameter requesting each write to the VSAM file to be validated by a read without data transfer.
    Default value: n
    Example: --wc y

    Allowed values: y, n

- `--control-interval-freespace-percentage` | `--cifp` (number)

  - Specifies the percentage of empty space in each control interval when the file is initially loaded.The free space lets records be inserted or expanded within a control interval before requiring a control interval split.
    Example: --cifp 10

- `--control-area-freespace-percentage` | `--cafp` (number)

  - Specifies the percentage of control intervals to be left unused in each control area as the file is initially loaded. The use of control area free space lets some control interval splits occur before requiring a control area split.
    Example: --cafp 10

- `--cross-region-share-option` | `--crso` (number)

  - Specifies that the file can be shared among regions within the same system or within multiple systems using GRS (Global Resource Serialization).
    The alloweThe allowed values have the following meaning:
    1 - The data set can be opened for read processing by an unlimited number of users, but the data set can be accessed by only one user when that user is doing read and write processing.
    2 - The data set can be opened by only one user at a time for read and write processing, but any number of users can also be accessing the data set for read processing
    3 - The data set can be fully shared by any number of users.
    4 - The data set can be fully shared by any number of users. VSAM immediately updates the data set for PUTs and refreshes all input buffers for GETs.
    Default value: 1
    Example: --crso 2

    Allowed values: 1, 2, 3, 4

- `--cross-system-share-option` | `--csso` (number)

  - Specifies how the file can be shared among systems.
    The allowed values have the following meaning:
    3 - The data set can be fully shared by any number of users.
    4 - The data set can be fully shared by any number of users. VSAM immediately updates the data set for PUTs and refreshes all input buffers for GETs.
    Default value: 3
    Example: --csso 4

    Allowed values: 3, 4

- `--expiration-date` | `--ed` (string)

  - Specifies the expiration date after which the data set can be deleted.
    Specify 'P' or 'p' to make the data set permanent, or an expiration date in YYYY-MM-DD format.
    Example: --ed 2032-07-31

- `--storage-class` | `--sc` (string)

  - Specifies the storage class.
    Example: --sc scl002

- `--management-class` | `--mc` (string)

  - Specifies the management class.
    Example: --mc mcl002

- `--data-class` | `--dc` (string)

  - Specifies the data class.
    Example: --dc dcl002

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Creating a LDS with default option values:

  - `zowe file-master-plus create vsam-lds fmmvs.test.dsname`

- Creating a LDS with options:

  - `zowe file-master-plus create vsam-lds fmmvs.test.dsname --dcis 3584 --dsu cyl --dps 1 --dss 3 --dv vol002 --bs 37376 -e y -r y -s n --ed p`

- Creating a LDS data set like a model LDS data set:

  - `zowe file-master-plus create vsam-lds fmmvs.test.dsname --model fmmvs.model.dsname`

- Creating a LDS like a model LDS data set and overriding the parameters with options:

  - `zowe file-master-plus create vsam-lds fmmvs.test.dsname --model fmmvs.model.dsname --wc y --bs 37376 --crso 3 --csso 4 --ed 2025-09-27`

### zowe › file-master-plus › create › vsam-rrds

Create a relative-record data set (RRDS) Virtual Storage Access Method (VSAM) data set.

#### Usage

zowe file-master-plus create vsam-rrds <name> [options]

#### Positional Arguments

- `name` (string)

  - Specifies the name of the data set to create.

#### Options

- `--model` | `-m` (string)

  - Specifies the name of a model RRDS (relative-record VSAM data set) for allocating parameters.
    The parameters of the model data set override all defaults.
    Example: -m fmmvs.model.dsname

- `--maximum-record-size` | `--mrs` (number)

  - Specifies the maximum length of data records.
    This parameter is mandatory unless a model data set is specified.
    Example: --mrs 180

- `--data-dsname` | `--ddsn` (string)

  - Specifies the data set name of the data VSAM component.
    If this parameter is not specified then by default it is set to the cluster name with ‘.DATA’.
    Example: --ddsn fmmvs.vsam.rrds.data

- `--data-control-interval-size` | `--dcis` (number)

  - Specifies the size of the Control Interval for the data VSAM component.
    Default value: 20480
    Example: --dcis 3584

- `--data-space-units` | `--dsu` (string)

  - Specifies the space allocation unit for data vsam component.
    The allowed values have the following meaning:
    TRK - Tracks
    CYL - Cylinders
    REC - Records
    K - Kilobytes
    M - Megabytes
    Default value: TRK
    Example: --dsu rec

    Allowed values: TRK, CYL, REC, K, M

- `--data-primary-space` | `--dps` (number)

  - Specifies the primary space allocation unit for the data VSAM component.
    Allowed values: 1-16777215
    Default value: 18
    Example: --dps 3

- `--data-secondary-space` | `--dss` (number)

  - Specifies the secondary space allocation unit for the data VSAM component.
    Allowed values: 1-16777215
    Default value: 3
    Example: --dss 5

- `--data-volume` | `--dv` (array)

  - Specifies a disk volume or specific tapes for the data VSAM component.
    Example: -dv vol002

- `--buffer-space` | `--bs` (number)

  - Specifies the minimum buffer space to allocate when this VSAM file is accessed.
    Example: --bs 37376

- `--erase` | `-e` (string)

  - Indicates whether the VSAM file was allocated with the ERASE parameter, causing all components of the file to be overwritten with binary zeros, when the VSAM file is deleted from the catalog.
    Default value: n
    Example: -e y

    Allowed values: y, n

- `--load-restartable` | `--lr` (string)

  - Specify 'Y' to request that the VSAM component definition use the 'RECOVERY' parameter (which causes the data component to be preformatted previous to the initial load). Using this option causes the initial load to take longer, but loads which do not complete successfully can be restarted.
    Specify 'N' to request that the VSAM component definition use the 'SPEED' parameter (which causes the data component to NOT be preformatted previous to the initial load).
    Default value: n
    Example: -lr y

    Allowed values: y, n

- `--reuse` | `-r` (string)

  - Indicates whether the VSAM file was allocated with the REUSE parameter specifying that the cluster can be opened again and again as a reusable cluster.
    Default value: n
    Example: -r y

    Allowed values: y, n

- `--write-check` | `--wc` (string)

  - Indicates whether the VSAM file was allocated with the WRITECHECK parameter requesting each write to the VSAM file to be validated by a read without data transfer.
    Default value: n
    Example: --wc y

    Allowed values: y, n

- `--control-interval-freespace-percentage` | `--cifp` (number)

  - Specifies the percentage of empty space in each control interval when the file is initially loaded.The free space lets records be inserted or expanded within a control interval before requiring a control interval split.
    Example: --cifp 10

- `--control-area-freespace-percentage` | `--cafp` (number)

  - Specifies the percentage of control intervals to be left unused in each control area as the file is initially loaded. The use of control area free space lets some control interval splits occur before requiring a control area split.
    Example: --cafp 10

- `--cross-region-share-option` | `--crso` (number)

  - Specifies that the file can be shared among regions within the same system or within multiple systems using GRS (Global Resource Serialization).
    The allowed values have the following meaning:
    1 - The data set can be opened for read processing by an unlimited number of users, but the data set can be accessed by only one user when that user is doing read and write processing.
    2 - The data set can be opened by only one user at a time for read and write processing, but any number of users can also be accessing the data set for read processing
    3 - The data set can be fully shared by any number of users.
    4 - The data set can be fully shared by any number of users. VSAM immediately updates the data set for PUTs and refreshes all input buffers for GETs.
    Default value: 1
    Example: --crso 2

    Allowed values: 1, 2, 3, 4

- `--cross-system-share-option` | `--csso` (number)

  - Specifies how the file can be shared among systems.
    The allowed values have the following meaning:
    3 - The data set can be fully shared by any number of users.
    4 - The data set can be fully shared by any number of users. VSAM immediately updates the data set for PUTs and refreshes all input buffers for GETs.
    Default value: 3
    Example: --csso 4

    Allowed values: 3, 4

- `--expiration-date` | `--ed` (string)

  - Specifies the expiration date after which the data set can be deleted.
    Specify 'P' or 'p' to make the data set permanent, or an expiration date in YYYY-MM-DD format.
    Example: --ed 2032-07-31

- `--storage-class` | `--sc` (string)

  - Specifies the storage class.
    Example: --sc scl002

- `--management-class` | `--mc` (string)

  - Specifies the management class.
    Example: --mc mcl002

- `--data-class` | `--dc` (string)

  - Specifies the data class.
    Example: --dc dcl002

- `--log` | `-l` (string)

  - When specified, 'ALL' or 'UNDO' or 'NONE' indicates the VSAM RLS recovery option.
    Example: --log ALL

    Allowed values: NONE, UNDO, ALL

- `--frlog` | `--fr` (string)

  - Specifies the type of VSAM batch logging to perform for this VSAM data set.
    The allowed values have the following meaning:
    NONE - Disables VSAM batch logging.
    REDO - Enables VSAM batch logging.
    UNDO - Changes made to your VSAM data set are backed out using VSAM batch logging.
    ALL - Changes made to your VSAM data set are backed out and forward recovered using VSAM batch logging.
    Example: --frlog ALL

    Allowed values: NONE, UNDO, ALL, REDO

- `--log-replicate` | `--lrp` (string)

  - Specify 'Y' to enable VSAM replication for this data set.
    Example: --lrp y

    Allowed values: Y, N

- `--log-stream-id` | `--lsi` (string)

  - Specifies the 1- to 26-character name of the forward recovery log stream.
    Example: --lsi LOGSTRA

- `--rls-enable` | `--rls` | `--re` (string)

  - Specify 'N' to disable VSAM record-level sharing.
    Default value: y
    Example: --rls n

    Allowed values: Y, N

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Creating a RRDS with default option values and mandatory options:

  - `zowe file-master-plus create vsam-rrds fmmvs.test.dsname --mrs 160`

- Creating a RRDS with options:

  - `zowe file-master-plus create vsam-rrds fmmvs.test.dsname --mrs 160 --dcis 3584 --dsu cyl --dps 1 --dss 3 --dv vol002 --bs 37376 -e y -r y -s n --ed p`

- Creating a RLS enabled RRDS with logging options:

  - `zowe file-master-plus create vsam-rrds fmmvs.test.dsname --mrs 160 --dcis 3584 --dsu cyl --dps 1 --dss 3 --dv vol002 --bs 37376 -e y -r y -s n --ed p --rls y -l all --lsi loga --lrp y --fr ALL`

- Creating a RRDS data set like a model RRDS data set:

  - `zowe file-master-plus create vsam-rrds fmmvs.test.dsname --model fmmvs.model.dsname`

- Creating a RRDS like a model RRDS data set and overriding the parameters with options:

  - `zowe file-master-plus create vsam-rrds fmmvs.test.dsname --model fmmvs.model.dsname --mrs 160 --wc y --bs 37376 --crso 3 --csso 4 --ed 2025-09-27`

### zowe › file-master-plus › create › vsam-vrrds

Create a variable-length relative-record data set (VRRDS) Virtual Storage Access Method (VSAM) data set.

#### Usage

zowe file-master-plus create vsam-vrrds <name> [options]

#### Positional Arguments

- `name` (string)

  - Specifies the name of the data set to create.

#### Options

- `--model` | `-m` (string)

  - Specifies the name of a model VRRDS (variable-length relative-record VSAM data set) for allocating parameters.
    The parameters of the model data set override all defaults.
    Example: -m fmmvs.model.dsname

- `--maximum-record-size` | `--mrs` (number)

  - Specifies the maximum length of data records.
    This parameter is mandatory unless a model data set is specified and it should be greater than the average record size.
    Example: --mrs 180

- `--average-record-size` | `--ars` (number)

  - Specifies the average length of data records.
    This parameter is mandatory unless a model data set is specified and it should be less than the maximum record size.
    Example: --ars 110

- `--data-dsname` | `--ddsn` (string)

  - Specifies the data set name of the data VSAM component.
    If this parameter is not specified then by default it is set to the cluster name with ‘.DATA’.
    Example: --ddsn fmmvs.vsam.ksds.data

- `--data-control-interval-size` | `--dcis` (number)

  - Specifies the size of the Control Interval for the data VSAM component.
    Default value: 20480
    Example: --dcis 3584

- `--data-space-units` | `--dsu` (string)

  - Specifies the space allocation unit for data vsam component.
    The allowed values have the following meaning:
    TRK - Tracks
    CYL - Cylinders
    REC - Records
    K - Kilobytes
    M - Megabytes
    Default value: TRK
    Example: --dsu rec

    Allowed values: TRK, CYL, REC, K, M

- `--data-primary-space` | `--dps` (number)

  - Specifies the primary space allocation unit for the data VSAM component.
    Allowed values: 1-16777215
    Default value: 18
    Example: --dps 3

- `--data-secondary-space` | `--dss` (number)

  - Specifies the secondary space allocation unit for the data VSAM component.
    Allowed values: 1-16777215
    Default value: 3
    Example: --dss 5

- `--data-volume` | `--dv` (array)

  - Specifies a disk volume or specific tapes for the data VSAM component.
    Example: -dv vol002

- `--index-dsname` | `--idsn` (string)

  - Specifies the data set name of the index VSAM component.
    If this parameter is not specified then it is set to the cluster name with ‘.INDEX’ appended.
    Example: --ddsn fmmvs.vsam.ksds.index

- `--index-control-interval-size` | `--icis` (number)

  - Specifies the size of Control Interval for index VSAM component.
    Default value: 512
    Example: --icis 3584

- `--index-space-units` | `--isu` (string)

  - Specifies the space allocation unit for index VSAM component.
    The allowed values have the following meaning:
    TRK - Tracks
    CYL - Cylinders
    REC - Records
    K - Kilobytes
    M - Megabytes
    Default value: TRK
    Example: --isu cyl

    Allowed values: TRK, CYL, REC, K, M

- `--index-primary-space` | `--ips` (number)

  - Specifies primary space allocation unit for index VSAM component.
    Allowed values: 1-16777215
    Default value: 1
    Example: --ips 3

- `--index-secondary-space` | `--iss` (number)

  - Specifies secondary space allocation unit for index VSAM component.
    Allowed values: 1-16777215
    Default value: 1
    Example: --iss 5

- `--index-volume` | `--iv` (array)

  - Specifies a disk volume or specific tapes for the data VSAM component.
    Example: -iv vol002

- `--buffer-space` | `--bs` (number)

  - Specifies the minimum buffer space to allocate when this VSAM file is accessed.
    Example: --bs 37376

- `--erase` | `-e` (string)

  - Indicates whether the VSAM file was allocated with the ERASE parameter, causing all components of the file to be overwritten with binary zeros, when the VSAM file is deleted from the catalog.
    Default value: n
    Example: -e y

    Allowed values: y, n

- `--load-restartable` | `--lr` (string)

  - Specify 'Y' to request that the VSAM component definition use the 'RECOVERY' parameter (which causes the data component to be preformatted previous to the initial load). Using this option causes the initial load to take longer, but loads which do not complete successfully can be restarted.
    Specify 'N' to request that the VSAM component definition use the 'SPEED' parameter (which causes the data component to NOT be preformatted previous to the initial load).
    Default value: n
    Example: -lr y

    Allowed values: y, n

- `--reuse` | `-r` (string)

  - Indicates whether the VSAM file was allocated with the REUSE parameter specifying that the cluster can be opened again and again as a reusable cluster.
    Default value: n
    Example: -r y

    Allowed values: y, n

- `--write-check` | `--wc` (string)

  - Indicates whether the VSAM file was allocated with the WRITECHECK parameter requesting each write to the VSAM file to be validated by a read without data transfer.
    Default value: n
    Example: --wc y

    Allowed values: y, n

- `--control-interval-freespace-percentage` | `--cifp` (number)

  - Specifies the percentage of empty space in each control interval when the file is initially loaded.The free space lets records be inserted or expanded within a control interval before requiring a control interval split.
    Example: --cifp 10

- `--control-area-freespace-percentage` | `--cafp` (number)

  - Specifies the percentage of control intervals to be left unused in each control area as the file is initially loaded. The use of control area free space lets some control interval splits occur before requiring a control area split.
    Example: --cafp 10

- `--cross-region-share-option` | `--crso` (number)

  - Specifies that the file can be shared among regions within the same system or within multiple systems using GRS (Global Resource Serialization).
    The allowed values have the following meaning:
    1 - The data set can be opened for read processing by an unlimited number of users, but the data set can be accessed by only one user when that user is doing read and write processing.
    2 - The data set can be opened by only one user at a time for read and write processing, but any number of users can also be accessing the data set for read processing
    3 - The data set can be fully shared by any number of users.
    4 - The data set can be fully shared by any number of users. VSAM immediately updates the data set for PUTs and refreshes all input buffers for GETs.
    Default value: 1
    Example: --crso 2

    Allowed values: 1, 2, 3, 4

- `--cross-system-share-option` | `--csso` (number)

  - Specifies how the file can be shared among systems.
    The allowed values have the following meaning:
    3 - The data set can be fully shared by any number of users.
    4 - The data set can be fully shared by any number of users. VSAM immediately updates the data set for PUTs and refreshes all input buffers for GETs.
    Default value: 3
    Example: --csso 4

    Allowed values: 3, 4

- `--expiration-date` | `--ed` (string)

  - Specifies the expiration date after which the data set can be deleted.
    Specify 'P' or 'p' to make the data set permanent, or an expiration date in YYYY-MM-DD format.
    Example: --ed 2032-07-31

- `--storage-class` | `--sc` (string)

  - Specifies the storage class.
    Example: --sc scl002

- `--management-class` | `--mc` (string)

  - Specifies the management class.
    Example: --mc mcl002

- `--data-class` | `--dc` (string)

  - Specifies the data class.
    Example: --dc dcl002

- `--log` | `-l` (string)

  - When specified, 'ALL' or 'UNDO' or 'NONE' indicates the VSAM RLS recovery option.
    Example: --log ALL

    Allowed values: NONE, UNDO, ALL

- `--frlog` | `--fr` (string)

  - Specifies the type of VSAM batch logging to perform for this VSAM data set.
    The allowed values have the following meaning:
    NONE - Disables VSAM batch logging.
    REDO - Enables VSAM batch logging.
    UNDO - Changes made to your VSAM data set are backed out using VSAM batch logging.
    ALL - Changes made to your VSAM data set are backed out and forward recovered using VSAM batch logging.
    Example: --frlog ALL

    Allowed values: NONE, UNDO, ALL, REDO

- `--log-replicate` | `--lrp` (string)

  - Specify 'Y' to enable VSAM replication for this data set.
    Example: --lrp y

    Allowed values: Y, N

- `--log-stream-id` | `--lsi` (string)

  - Specifies the 1- to 26-character name of the forward recovery log stream.
    Example: --lsi LOGSTRA

- `--rls-enable` | `--rls` | `--re` (string)

  - Specify 'N' to disable VSAM record-level sharing.
    Default value: y
    Example: --rls n

    Allowed values: Y, N

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Creating a VRRDS with default option values and mandatory options:

  - `zowe file-master-plus create vsam-vrrds fmmvs.test.dsname --mrs 160`

- Creating a VRRDS with options:

  - `zowe file-master-plus create vsam-vrrds fmmvs.test.dsname --mrs 160 --ars 120 --dcis 3584 --dsu cyl --dps 1 --dss 3 --dv vol002 --icis 512 --isu cyl --ips 1 --iss 1 --iv vol002 --bs 37376 -e y -r y --ed 2025-09-27`

- Creating a RLS enabled VRRDS with logging options:

  - `zowe file-master-plus create vsam-vrrds fmmvs.test.dsname --mrs 160 --ars 120 --dcis 3584 --dsu cyl --dps 1 --dss 3 --dv vol002 --icis 512 --isu cyl --ips 1 --iss 1 --iv vol002 --bs 37376 -e y -r y --rls y -l all --lsi loga --lrp y --fr ALL`

- Creating a VRRDS data set like a model VRRDS data set:

  - `zowe file-master-plus create vsam-vrrds fmmvs.test.dsname --model fmmvs.model.dsname`

- Creating a VRRDS like a model VRRDS data set and overriding the parameters with options:

  - `zowe file-master-plus create vsam-vrrds fmmvs.test.dsname --model fmmvs.model.dsname --mrs 160 --wc y --bs 37376 --crso 3 --csso 4 --ed p`

## zowe › file-master-plus › delete

Permanently deletes a data set.

### zowe › file-master-plus › delete › data-set

Permanently deletes a data set.
It supports all data set types that are supported by File Master Plus.

#### Usage

zowe file-master-plus delete data-set <name> [options]

#### Positional Arguments

- `name` (string)

  - Specifies the name of the data set that you want to delete.

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Deleting a data set:

  - `zowe file-master-plus delete data-set fmmvs.dsname`

## zowe › file-master-plus › populate

Populate the specified data set with records.
It supports all data set types that are supported by File Master Plus.

### zowe › file-master-plus › populate › data-set

Populate a specific data set with records.
The layout of the records to add are described by a Cobol or PL/I copybook.

#### Usage

zowe file-master-plus populate data-set <name> [options]

#### Positional Arguments

- `name` (string)

  - Specifies the name of the data set to populate.

#### Options

- `--member` | `-m` (string)

  - Specifies name of the member.
    Note: Used only if the specified data set is a PDS or PDSE.
    Example: -m member1.

#### Required Options

- `--layout-member` | `--lm` (string)

  - Specifies the name of the Cobol or PL/I copybook.
    Example: --lm testlay.

- `--layout-data-set` | `--lds` (string)

  - Specifies the name of the data set that contains the layout member.
    Example: --lds fmmvs.layout.dataset.

- `--data` | `-d` (string)

  - Specifies path of the .txt/.json file of the data stream. Ensure the data stream is an array in JSON format represented by a layout data set and its member.
    Example: -d ../instream/data1.txt

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Populating a data set:

  - `zowe file-master-plus populate data-set fmmvs.dsname --lds fmmvs.layout.dataset --lm testlay --data ../instream/data1.txt`

## zowe › file-master-plus › rename

Rename the specified data set.

### zowe › file-master-plus › rename › data-set

Rename a data set.
It supports all data set types that are supported by File Master Plus.

#### Usage

zowe file-master-plus rename data-set <old> <new> [options]

#### Positional Arguments

- `old` (string)

  - Specifies the name of the data set that you want to rename.

- `new` (string)

  - Specifies the new name of the data set.

#### Options

- `--vsam-component` | `--vsamc` (string)

  - Rename the data and index components of a VSAM cluster if they share the cluster name.
    Note: Used only if the target data set is a VSAM cluster.
    Example: --vsamc y.

    Default value: n
    Allowed values: y, n

#### FMP Connection Options

- `--host` | `-H` (string)

  - Specifies File Master Plus server host name.

- `--port` | `-P` (number)

  - Specifies File Master Plus server port.

    Default value: 51914

- `--user` | `-u` (string)

  - Specifies Mainframe user name. May be the same as TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Specifies Mainframe password. May be the same as TSO password.

- `--protocol` | `-o` (string)

  - Specifies File Master Plus REST API protocol.

    Default value: https
    Allowed values: http, https

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all FMP resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

#### Profile Options

- `--fmp-profile` | `--fmp-p` (string)

  - The name of a (fmp) 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

- `--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

- Renaming a data set:

  - `zowe file-master-plus rename data-set fmmvs.old.dsname fmmvs.new.dsname`

- Renaming a VSAM data set along with its components:

  - `zowe file-master-plus rename data-set fmmvs.oldvsam.dsname fmmvs.newvsam.dsname --vsamc y`

## zowe › idms

IDMS plug-in for listing real-time monitor statistics and information, viewing DC log messages, and issuing DCMT and DCUF commands

## zowe › idms › issue

Issues IDMS DCMT and DCUF commands

### zowe › idms › issue › dcmt-display

Execute a DCMT DISPLAY command

#### Usage

zowe idms issue dcmt-display [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

- `--datasource` | `-d` (string)

  - Identifies the IDMS system where the API request will be sent and is defined in the data sources definition file for the IDMS REST API

#### Required Options

- `--args` (string)

  - DCMT DISPLAY command arguments

#### Options

- `--broadcast` | `-b` (string)

  - Broadcast parameters used if the system is part of a data sharing group

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Issues a 'dcmt display task send' command to display information associated with the SEND task:

  - `zowe idms issue dcmt-display --args "task send"`

- Issues a 'dcmt display active programs' command with an IDMS profile and data source to override the default:

  - `zowe idms issue dcmt-display --args "active programs" --idms-profile myprofile2 --datasource sysdemo`

### zowe › idms › issue › dcmt-help

Execute a DCMT HELP command

#### Usage

zowe idms issue dcmt-help [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

- `--datasource` | `-d` (string)

  - Identifies the IDMS system where the API request will be sent and is defined in the data sources definition file for the IDMS REST API

#### Options

- `--args` (string)

  - DCMT HELP command arguments

- `--broadcast` | `-b` (string)

  - Broadcast parameters used if the system is part of a data sharing group

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Issues a 'dcmt help' command to display a summary of the syntax for DCMT commands:

  - `zowe idms issue dcmt-help`

- Issues a 'dcmt help task' command with a data source to override the default:

  - `zowe idms issue dcmt-help --args "task" --datasource sysdemo`

### zowe › idms › issue › dcmt-quiesce

Execute a DCMT QUIESCE command

#### Usage

zowe idms issue dcmt-quiesce [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

- `--datasource` | `-d` (string)

  - Identifies the IDMS system where the API request will be sent and is defined in the data sources definition file for the IDMS REST API

#### Required Options

- `--args` (string)

  - DCMT QUIESCE command arguments. Specifies the DCMT QUIESCE target area, segment, or DBNAME

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Issues the command 'dcmt quiesce dbname empdemo id 1' which quiesces all areas associated with segments includedin the EMPDEMO database and assigns the operation to dcmt-id 1:

  - `zowe idms issue dcmt-quiesce --args "dbname empdemo id 1"`

- Issues the command 'dcmt quiesce area emp* id 2' which quiesces all areas whose segment name begins with EMP andassigns the operation to dcmt-id 2:

  - `zowe idms issue dcmt-quiesce --args "area emp* id 2"`

### zowe › idms › issue › dcmt-shutdown

Execute a DCMT SHUTDOWN command

#### Usage

zowe idms issue dcmt-shutdown [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

- `--datasource` | `-d` (string)

  - Identifies the IDMS system where the API request will be sent and is defined in the data sources definition file for the IDMS REST API

#### Required Options

- `--args` (string)

  - DCMT SHUTDOWN command arguments. NOPROMPT must be specified. IMMEDIATE is optional

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Issues a 'dcmt shutdown noprompt' command to shut down the DC/UCF system while allowing all active tasks andexternal run units to terminate normally first:

  - `zowe idms issue dcmt-shutdown --args "noprompt"`

- Issues a 'dcmt shutdown noprompt immediate' command to immediately shut down the DC/UCF system, abending allactive tasks and external run units with code SHUT:

  - `zowe idms issue dcmt-shutdown --args "noprompt immediate"`

### zowe › idms › issue › dcmt-statistics

Execute a DCMT STATISTICS command

#### Usage

zowe idms issue dcmt-statistics [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

- `--datasource` | `-d` (string)

  - Identifies the IDMS system where the API request will be sent and is defined in the data sources definition file for the IDMS REST API

#### Options

- `--args` (string)

  - DCMT STATISTICS command arguments. Can specify ROLL to reset statistics to zero after writing them

- `--broadcast` | `-b` (string)

  - Broadcast parameters used if the system is part of a data sharing group

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Issues a 'dcmt write statistics roll' command to write the current system and line statistics and histogramsto the log file and then reset their values to zero:

  - `zowe idms issue dcmt-statistics --args "roll"`

### zowe › idms › issue › dcmt-test

Execute a DCMT TEST command. Obtains diagnostic information for Broadcom technical support personnel.

The DCMT TEST command is used for debugging and diagnostic purposes only. Use it only when told to do so by IDMS technical support personnel. It is enabled only if certain CSA test flags are turned on

#### Usage

zowe idms issue dcmt-test [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

- `--datasource` | `-d` (string)

  - Identifies the IDMS system where the API request will be sent and is defined in the data sources definition file for the IDMS REST API

#### Required Options

- `--args` (string)

  - DCMT TEST command arguments. Specifies which debugging options to use

#### Options

- `--broadcast` | `-b` (string)

  - Broadcast parameters used if the system is part of a data sharing group

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Issues a 'dcmt test debug options' command, with 'debug options' being the options provided by IDMS technical support:

  - `zowe idms issue dcmt-test --args "debug options"`

### zowe › idms › issue › dcmt-vary

Execute a DCMT VARY command

#### Usage

zowe idms issue dcmt-vary [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

- `--datasource` | `-d` (string)

  - Identifies the IDMS system where the API request will be sent and is defined in the data sources definition file for the IDMS REST API

#### Required Options

- `--args` (string)

  - DCMT VARY command arguments

#### Options

- `--broadcast` | `-b` (string)

  - Broadcast parameters used if the system is part of a data sharing group

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Issues a 'dcmt vary task signon enabled' command to enable the SIGNON task:

  - `zowe idms issue dcmt-vary --args "task signon enabled"`

- Issues a 'dcmt vary journal swap' command with an IDMS profile and data source to override the default:

  - `zowe idms issue dcmt-vary --args "journal swap" --idms-profile myprofile2 --datasource sysdemo`

### zowe › idms › issue › dcuf-help

Execute a DCUF HELP command

#### Usage

zowe idms issue dcuf-help [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

- `--datasource` | `-d` (string)

  - Identifies the IDMS system where the API request will be sent and is defined in the data sources definition file for the IDMS REST API

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Issues a 'dcuf help' command to display a list of DCUF commands and parameters.Note: Only SHOW commands are supported by the CLI:

  - `zowe idms issue dcuf-help`

### zowe › idms › issue › dcuf-show

Execute a DCUF SHOW command

#### Usage

zowe idms issue dcuf-show [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

- `--datasource` | `-d` (string)

  - Identifies the IDMS system where the API request will be sent and is defined in the data sources definition file for the IDMS REST API

#### Required Options

- `--args` (string)

  - DCUF SHOW command arguments

#### Options

- `--broadcast` | `-b` (string)

  - Broadcast parameters used if the system is part of a data sharing group

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Issues a 'dcuf show tables' command to display a list of the available tables:

  - `zowe idms issue dcuf-show --args "tables"`

- Issues a 'dcuf show user <username>' command to display information about a specific user:

  - `zowe idms issue dcuf-show --args "user username"`

## zowe › idms › list

Lists available datasources, real-time monitor statistics information, log messages, active user tasks, and transaction details

### zowe › idms › list › datasources

Lists data sources defined to the IDMS REST API

#### Usage

zowe idms list datasources [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

#### Options

- `--datasourcename` | `--dsn` (string)

  - Specifies a specific datasource to view the definition of

- `--all` | `-a` (boolean)

  - Lists each datasource defined to the IDMS REST API

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Lists all data sources defined to the IDMS Rest API:

  - `zowe idms list datasources --all`

- Lists a single IDMS data source identified by the data source name:

  - `zowe idms list datasources --dsn SYSDEMO`

### zowe › idms › list › log

Lists log messages based on the search options provided

#### Usage

zowe idms list log [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

- `--datasource` | `-d` (string)

  - Identifies the IDMS system where the API request will be sent and is defined in the data sources definition file for the IDMS REST API

#### Required Options

- `--start-time` | `--st` (string)

  - Start time of the first log message

    Format: 'YYYY-MM-DD HH:mm:ss[.SSSSSS]'

- `--end-time` | `--et` (string)

  - End time of the last log message

    Format: 'YYYY-MM-DD HH:mm:ss[.SSSSSS]'

#### Options

- `--record-type` | `--rt` (string)

  - Type of log records:

    1 - #WTL text line

    2 - User trace text or physical I/O trace text

    3 - User binary trace entries

    4 - Snap or dump text

    5 - Snap or dump binary entries

    Examples: '1,2', '1,4,5', '2'

- `--record-identifier` | `--ri` (string)

  - Identifier contained in log messages

    Examples: 'LTE0001,LTVTM011', 'DCSYSTEM', 'SYSTE160'

- `--search-text` | `--stext` (string)

  - Text contained in log messages

    Examples: 'DB001108', 'any_text_that_might_exist_in_the_message'

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Lists all the log messages where the time stamps satisfy the start and end time criteria:

  - `zowe idms list log --start-time "2020-08-05 09:20:00" --end-time "2020-08-05 10:20:00"`

- Lists all the #WTL log messages where 'DB001108' is contained in the log messageand where the time stamps satisfy the start and end time criteria:

  - `zowe idms list log --start-time "2020-08-05 09:20:00" --end-time "2020-08-05 10:20:00" --record-type 1 --search-text DB001108`

- Lists all log messages with the DCSYSTEM record identifier where the time stamps satisfy the start and end time criteria:

  - `zowe idms list log --start-time "2020-08-05 08:00:00.001234" --end-time "2020-08-05 13:43:33.26" --record-identifier DCSYSTEM`

### zowe › idms › list › systems

Lists either all active IDMS systems on an LPAR or lists information about a specific system if a jobname is provided

#### Usage

zowe idms list systems [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

#### Options

- `--jobname` | `-j` (string)

  - The job name of the active IDMS system

- `--all` | `-a` (boolean)

  - Lists all active systems. This is the default behavior if no job name is provided

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Lists all active IDMS systems on the LPAR where the IDMS REST API service is running:

  - `zowe idms list systems --all`

- Lists a single active IDMS system identified by the IDMS system job name:

  - `zowe idms list systems --jobname SYSDEMO`

### zowe › idms › list › transactions

Lists transaction details on a specific IDMS system

#### Usage

zowe idms list transactions [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

#### Required Options

- `--jobname` | `-j` (string)

  - The job name of the active IDMS system

- `--datasourcename` | `--dsn` (string)

  - The data source name of the specified IDMS system

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Lists the transaction details of the IDMS system identified by the IDMS system job name:

  - `zowe idms list transactions --jobname SYSDEMO`

- Lists the transaction details of the IDMS system identified by the IDMS system job name as JSON formatted data:

  - `zowe idms list transactions --jobname SYSDEMO --rfj`

### zowe › idms › list › user-tasks

Lists all active user tasks on a specific IDMS system

#### Usage

zowe idms list user-tasks [options]

#### IDMS Connection Options

- `--host` | `-H` (string)

  - Host name of the IDMS REST API service

- `--port` | `-P` (number)

  - Port for the IDMS REST API service

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login ID

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an API Mediation Layer

- `--token-type` | `--tt` (string)

  - The token type for z/OSMF returned in the HTTP Cookie header, for example: 'LtpaToken2'. The existence of a 'tokenType' indicates that basic authentication will not be used after a token has been obtained

- `--token-value` | `--tv` (string)

  - The token value associated with the token type

#### Required Options

- `--jobname` | `-j` (string)

  - The job name of the active IDMS system

- `--datasourcename` | `--dsn` (string)

  - The data source name of the specified IDMS system

#### Profile Options

- `--idms-profile` | `--idms-p` (string)

  - The name of a (idms) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Lists the active user tasks of the IDMS system identified by the IDMS system job name:

  - `zowe idms list user-tasks --jobname SYSDEMO`

- Lists the active user tasks of the IDMS system identified by the IDMS system job name as JSON formatted data:

  - `zowe idms list user-tasks --jobname SYSDEMO --rfj`

## zowe › jclcheck

Validates the accuracy of job control language (JCL) and also helps identify execution-time errors, such as security violations and missing data sets that could cause jobs to fail.

## zowe › jclcheck › check

Perform a check on JCL that is contained in an MVS data set or a local file.

### zowe › jclcheck › check › data-set

Reads the specified input data set and invokes the JCLCheck service with the data set contents.

#### Usage

zowe jclcheck check data-set <dataSet> [options]

#### Positional Arguments

- `dataSet` (string)

  - The MVS data set containing the JCL contents. The data set can be a physical sequential (PS) or partitioned data set (PDS) member. The data set attributes must be recfm fixed-block (FB) and lrecl 80. The data set must be catalogued.

#### Options

- `--max-return-code` | `--mrc` (number)

  - Specifies the maximum acceptable return code from the JCLCheck service. If the JCLCheck overall return code exceeds the value specified on this option, the command will exit with a failure status code of 1.

- `--raw-output` | `--ro` (boolean)

  - Causes the command to print the unformatted JCLCheck report (raw report) instead of the formatted error table. Use this option if you intend to change the format of the JCLCheck report via runtime options. Changing the format may affect the ability to produce a structured API response.

    Default value: false

#### JCLCheck Connection Options

- `--host` | `-H` (string)

  - Host name of the JCLCheck API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the JCLCheck API service that is running on the mainframe system.

    Default value: 12697

- `--user` | `-u` (string)

  - User name for authenticating connections to the JCLCheck API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the JCLCheck API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

    Default value: cajclcheck/api/v1

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies protocol to use for JCLCheck connection (http or https).

    Default value: https
    Allowed values: http, https

- `--jclcheck-options` | `--jo` (string)

  - The desired set of JCLCheck runtime options. Specify the options exactly as you would on the PARM= or OPTIONS DD on a batch run of JCLCheck. See the JCLCheck runtime options documentation for details on available runtime options. If you specify options that change the format of the JCLCheck reports, you should request '--raw-output'. Changing the format of the report will affect the ability to produce a structured API response.

#### Profile Options

- `--jclcheck-profile` | `--jclcheck-p` (string)

  - The name of a (jclcheck) 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

- `--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

- Check the JCL contained in "MY.DATASET(JCL)" and print a table of statements in error:

  - `zowe jclcheck check data-set "MY.DATASET(JCL)" --host hostname --port 1234 --jclcheck-options "NOAS NOAU NOHCD NOJCL NORES NOSIGN"`

- Check the JCL contained in "MY.DATASET(JCL)" and print the raw JCLCheck report:

  - `zowe jclcheck check data-set "MY.DATASET(JCL)" --host hostname --port 1234 --jclcheck-options "NOAS NOAU NOHCD NOJCL NORES NOSIGN" --raw-output`

### zowe › jclcheck › check › local-file

Reads the contents of the local file specified and invokes the JCLCheck service with the JCL contents.

#### Usage

zowe jclcheck check local-file <localFile> [options]

#### Positional Arguments

- `localFile` (string)

  - The local file containing the JCL to check. The local JCL file can contain a single job or multiple jobs (specified one after another without blank lines or line breaks). The JCL lines in the file must not exceed 80 characters.

#### Options

- `--max-return-code` | `--mrc` (number)

  - Specifies the maximum acceptable return code from the JCLCheck service. If the JCLCheck overall return code exceeds the value specified on this option, the command will exit with a failure status code of 1.

- `--raw-output` | `--ro` (boolean)

  - Causes the command to print the unformatted JCLCheck report (raw report) instead of the formatted error table. Use this option if you intend to change the format of the JCLCheck report via runtime options. Changing the format may affect the ability to produce a structured API response.

    Default value: false

#### JCLCheck Connection Options

- `--host` | `-H` (string)

  - Host name of the JCLCheck API service that is running on the mainframe system.

- `--port` | `-P` (number)

  - Port for the JCLCheck API service that is running on the mainframe system.

    Default value: 12697

- `--user` | `-u` (string)

  - User name for authenticating connections to the JCLCheck API service that is running on the mainframe system.

- `--password` | `--pass` | `--pw` (string)

  - Password for authenticating connections to the JCLCheck API service that is running on the mainframe system.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

    Default value: cajclcheck/api/v1

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies protocol to use for JCLCheck connection (http or https).

    Default value: https
    Allowed values: http, https

- `--jclcheck-options` | `--jo` (string)

  - The desired set of JCLCheck runtime options. Specify the options exactly as you would on the PARM= or OPTIONS DD on a batch run of JCLCheck. See the JCLCheck runtime options documentation for details on available runtime options. If you specify options that change the format of the JCLCheck reports, you should request '--raw-output'. Changing the format of the report will affect the ability to produce a structured API response.

#### Profile Options

- `--jclcheck-profile` | `--jclcheck-p` (string)

  - The name of a (jclcheck) 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

- `--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

- Check the JCL contained in the file "jcl.txt" and print a table of statements in error:

  - `zowe jclcheck check local-file jcl.txt --host hostname --port 1234 --jclcheck-options "NOAS NOAU NOHCD NOJCL NORES NOSIGN"`

- Check the JCL contained in the file "jcl.txt" and print the raw JCLCheck report:

  - `zowe jclcheck check local-file jcl.txt --host hostname --port 1234 --jclcheck-options "NOAS NOAU NOHCD NOJCL NORES NOSIGN" --raw-output`

## zowe › mat

The MAT Analyze plug-in for ZOWE CLI enables you to manage monitor profiles and get the measurement analysis data using Mainframe Application Tuner (MAT)

## zowe › mat › monitor

Get monitor history and measurement analysis data from MAT.

## zowe › mat › monitor › codeview

Get the CodeView measurement details.

### zowe › mat › monitor › codeview › callerid

Get the CodeView CallerID details for the specific CSECT and module.

#### Usage

zowe mat monitor codeview callerid [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--module` (string)

  - Specifies the module name that you request the CallerID details for. You get the module value from the 'codeview csect' command response. The module name can be empty (e.g., --module "IGZCPAC" or --module '""').

- `--csect` (string)

  - Specifies the CSECT name that you request the CallerID details for. You get the csect value from the 'codeview csect' command response. The CSECT name can be empty (e.g., --csect "TUNCOB01" or --csect '""').

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the CallerID details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB:

  - `zowe mat monitor codeview callerid --mon_num 5 --csect "TUNCOB01" --module "RUNCOB"`

- Get the CallerID details for the latest monitor in the TESTPROF profile for CSECT name TUNCOB01 and empty module name:

  - `zowe mat monitor codeview callerid --profile TESTPROF --csect "TUNCOB01" --module '""'`

- Get the CallerID details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB, with the specific MAT profile details defined:

  - `zowe mat monitor codeview callerid --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --host "example.com" --port 12345 --user johndoe --password qwerty`

### zowe › mat › monitor › codeview › csect

Get the CodeView measurement details in Csect mode.

#### Usage

zowe mat monitor codeview csect [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the CodeView measurement details in Csect mode for monitor number 5:

  - `zowe mat monitor codeview csect --mon_num 5`

- Get the CodeView measurement details in Csect mode for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor codeview csect --profile TESTPROF`

- Get the CodeView measurement details in Csect mode for monitor number 5, with the specific MAT profile details defined:

  - `zowe mat monitor codeview csect --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty`

### zowe › mat › monitor › codeview › histogram

Get the Histogram details for the measurement.

#### Usage

zowe mat monitor codeview histogram [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--module` (string)

  - Specifies the module name that you request the Histogram data for. You get the module value from the 'codeview csect' command response. The module name can be empty (e.g., --module "IGZCPAC" or --module '""').

- `--csect` (string)

  - Specifies the CSECT name that you request the Histogram data for. You get the csect value from the 'codeview csect' command response. The CSECT name can be empty (e.g., --csect "TUNCOB01" or --csect '""').

- `--group` (string)

  - Specifies the histogram group size parameter that defines the resolution of the histogram (e.g., --group 32). If you do not specify the group parameter, the group size value defaults to 4 bytes. If the source program listing is registered with MAT, the group size parameter is ignored. The --group parameter is optional. Lower values of the --group parameter result in more granular representation of the histogram data. Values: numbers between 2 and 999999.

- `--top` (number)

  - Specifies the maximum number of the top consuming CSECT activity locations that you want to obtain in the response (e.g., --top 5). If you specify --top 0, you get the list of all CSECT activity locations that MAT has detected during the measurement.The --top parameter is optional. Values: numbers between 0 and 300.

- `--listing` (boolean)

  - Enables you to retrieve program listing details that pertain to the specific CSECT and statement. To use the listing retrieval option, you must install and configure the Endevor® Web Services and have the program listing for the specific measurement registered with MAT. The source code listing is retrieved through Endevor® footprints for Cobol, C/C++, and Assembler programs. The program listing file is downloaded to your local directory that you specified with the 'listingDir' parameter in your MAT configuration profile. When you request the histogram details with the '--listing' option, the 'histogram' command returns the additional 'listing' column that contains a reference to the program listing with the specific CSECT name, program type, line and column number that pertain to the requested CSECT and statement, for example, c:listingsSA420LE.asm:382:51. If you use Visual Studio Code (VS Code) IDE, you can click on the reference in the command responce in your VS Code terminal to navigate directly to the indicated source program location.The --listing parameter is optional.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the Histogram details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB:

  - `zowe mat monitor codeview histogram --mon_num 5 --csect "TUNCOB01" --module "RUNCOB"`

- Get the Histogram details for the latest monitor in the TESTPROF profile for CSECT name TUNCOB01, empty module name, limiting the group size to 32 bytes and the number of returned records to 5 top consumers:

  - `zowe mat monitor codeview histogram --profile TESTPROF --csect "TUNCOB01" --module '""' --top 5 --group 32`

- Get the Histogram details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB, limit the number of returned records to 5 top consumers, and request the listing details:

  - `zowe mat monitor codeview histogram --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --top 5 --listing`

- Get the Histogram details for monitor number 5, CSECT name TUNCOB01, and module name RUNCOB, with the specific MAT profile details defined:

  - `zowe mat monitor codeview histogram --mon_num 5 --csect "TUNCOB01" --module "RUNCOB" --host "example.com" --port 12345 --user johndoe --password qwerty`

### zowe › mat › monitor › codeview › module

Get the CodeView measurement details in Module mode.

#### Usage

zowe mat monitor codeview module [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the CodeView measurement details in Module mode for monitor number 5:

  - `zowe mat monitor codeview module --mon_num 5`

- Get the CodeView measurement details in Module mode for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor codeview module --profile TESTPROF`

- Get the CodeView measurement details in Module mode for monitor number 5, with the specific MAT profile details defined:

  - `zowe mat monitor codeview module --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty`

## zowe › mat › monitor › db2

Get the DB2 measurement details.

### zowe › mat › monitor › db2 › db2view

Get the DB2View details for the measurement.

#### Usage

zowe mat monitor db2 db2view [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--top` (number)

  - Specifies the maximum number of the top consuming DB2 statements that you want to obtain in the response (e.g., --top 5). If you specify --top 0, you get the list of all DB2 statements that MAT has detected during the measurement.The --top parameter is optional. Values: numbers between 0 and 300.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the DB2View details for monitor number 5:

  - `zowe mat monitor db2 db2view --mon_num 5`

- Get the DB2View details for the latest monitor in the TESTPROF profile, with the top consumer limitation set to 5 top consumers:

  - `zowe mat monitor db2 db2view --profile TESTPROF --top 5`

- Get the DB2View details for monitor number 5, with the specific MAT profile details defined:

  - `zowe mat monitor db2 db2view --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty`

### zowe › mat › monitor › db2 › sqlstmt

Get SQL details for the DB2 statement.

#### Usage

zowe mat monitor db2 sqlstmt [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--dbrm` (string)

  - Specifies the DBRM/Package name that the requested DB2 statement belongs to (e.g., --dbrm CUPBTSDY). You get the dbrm value from the 'db2 db2view ' command response.

- `--stmtnum` (number)

  - Specifies the statement number that you request the SQL details for (e.g., --stmtnum 464). You get the stmtnum value from the 'db2 db2view ' command response.

- `--totalsamps` (number)

  - Specifies the total number of samples taken for the requested statement (e.g., --totalsamps 1). You get the totalsamps value from the 'db2 db2view ' command response.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the DB2 SQL statement details for monitor number 5 for DBRM CUPBTSDY, statement number 464, with total number of taken samples 1:

  - `zowe mat monitor db2 sqlstmt --mon_num 5 --dbrm CUPBTSDY --stmtnum 464 --totalsamps 1`

- Get the DB2 SQL statement details for the latest monitor in the TESTPROF profile, for DBRM CUPBTSDY, statement number 464, with total number of taken samples 1:

  - `zowe mat monitor db2 sqlstmt --profile TESTPROF --dbrm CUPBTSDY --stmtnum 464 --totalsamps 1`

- Get the DB2 SQL statement details for monitor number 5 for DBRM CUPBTSDY, statement number 464, with total number of taken samples 1, and with the specific MAT profile details defined:

  - `zowe mat monitor db2 sqlstmt --mon_num 5 --dbrm CUPBTSDY --stmtnum 464 --totalsamps 1 --host "example.com" --port 12345 --user johndoe --password qwerty`

## zowe › mat › monitor › delayview

Get the DelayView measurement details.

### zowe › mat › monitor › delayview › address

Get the delay address details for the measurement.

#### Usage

zowe mat monitor delayview address [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--majorcategory` (string)

  - Specifies the major delay category name identified for the analysis item (e.g., --majorcategory "PC routine delay"). You get the majorcategory value from the 'delayview delay' command response.

- `--minorcategory` (string)

  - Specifies the minor delay category name identified for the analysis item (e.g., --minorcategory "PC CALL"). You get the minorcategory value from the 'delayview delay' command response.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the delay address details for majorcategory "PC routine delay" and minorcategory "PC CALL" for monitor number 5:

  - `zowe mat monitor delayview address --mon_num 5 –-majorcategory "PC routine delay" –-minorcategory "PC CALL"`

- Get the delay address details for majorcategory "PC routine delay" and minorcategory "PC CALL" for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor delayview address --profile TESTPROF –-majorcategory "PC routine delay" –-minorcategory "PC CALL"`

- Get the delay address details for majorcategory "PC routine delay" and minorcategory "PC CALL" for monitor number 5, with the specific MAT profile details defined:

  - `zowe mat monitor delayview address --mon_num 5 –-majorcategory "PC routine delay" –-minorcategory "PC CALL" --host "example.com" --port 12345 --user johndoe --password qwerty`

### zowe › mat › monitor › delayview › delay

Get the delay details for the measurement.

#### Usage

zowe mat monitor delayview delay [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the DelayView measurement details for monitor number 5:

  - `zowe mat monitor delayview delay --mon_num 5`

- Get the DelayView measurement details for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor delayview delay --profile TESTPROF`

- Get the DelayView measurement details for monitor number 5, with the specific MAT profile details defined:

  - `zowe mat monitor delayview delay --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty`

### zowe › mat › monitor › history

Get list of all available measurements that are stored in the history of the specific monitor profile.

#### Usage

zowe mat monitor history [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the list of all available measurements that are stored in the history of the monitor profile TESTPROF:

  - `zowe mat monitor history --profile TESTPROF`

- Get the list of all available measurements that are stored in the history of the monitor profile TESTPROF, with the specific MAT profile details defined:

  - `zowe mat monitor history --profile TESTPROF --host "example.com" --port 12345 --user johndoe --password qwerty`

## zowe › mat › monitor › idms

Get the IDMS measurement details.

### zowe › mat › monitor › idms › dml

Get the IDMS measurement details in DML mode.

#### Usage

zowe mat monitor idms dml [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the CodeView measurement details in Module mode for monitor number 5:

  - `zowe mat monitor idms dml --mon_num 5`

- Get the CodeView measurement details in Module mode for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor idms dml --profile TESTPROF`

- Get the dml details of the measurement for monitor number 5:

  - `zowe mat monitor idms dml dml --mon_num 5`

### zowe › mat › monitor › idms › module

Get the IDMS measurement details.

#### Usage

zowe mat monitor idms module [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--module` (string)

  - Specifies the module of the measurement.

- `--taskid` (number)

  - Specifies the taskid number.

- `--ruid` (number)

  - Specifies the ruid number.

- `--linecmd` (string)

  - Specifies the line command to be used for the row data

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the idms details of the measurement for monitor number 5:

  - `zowe mat monitor idms module --mon_num 5`

- Get the idms details of the measurement for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor idms module --profile TESTPROF`

- Get the module details of the measurement for monitor number 5:

  - `zowe mat monitor idms module module --mon_num 5`

- Specify the module | taskid | ruid | linecmd option of the measurement for the module mode:

  - `zowe mat monitor idms module --module SQLA01D | --taskid 1 | --ruid 19333 | --linecmd dispatch`

### zowe › mat › monitor › idms › task

Get the IDMS measurement details in Task mode.

#### Usage

zowe mat monitor idms task [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the CodeView measurement details in Module mode for monitor number 5:

  - `zowe mat monitor idms task --mon_num 5`

- Get the CodeView measurement details in Module mode for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor idms task --profile TESTPROF`

- Get the task details of the measurement for monitor number 5:

  - `zowe mat monitor idms task task --mon_num 5`

## zowe › mat › monitor › imsview

Get the IMS measurement details.

### zowe › mat › monitor › imsview › dbdname

Get the IMS View DBDName details for the measurement.

#### Usage

zowe mat monitor imsview dbdname [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the IMS View DBDName details for monitor number 5:

  - `zowe mat monitor imsview dbdname --mon_num 5`

- Get the IMS View DBDName details for the latest monitor in the TESTPROF profile, :

  - `zowe mat monitor imsview dbdname --profile TESTPROF`

### zowe › mat › monitor › imsview › imsview

Get the IMS View details for the measurement.

#### Usage

zowe mat monitor imsview imsview [options]

#### Options

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the IMS View details for monitor number 5:

  - `zowe mat monitor imsview imsview --mon_num 5`

- Get the IMS View details for the latest monitor in the TESTPROF profile, :

  - `zowe mat monitor imsview imsview --profile TESTPROF`

### zowe › mat › monitor › imsview › psbname

Get the IMS View PSBName details for the measurement.

#### Usage

zowe mat monitor imsview psbname [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the IMS View PSBName details for monitor number 5:

  - `zowe mat monitor imsview psbname --mon_num 5`

- Get the IMS View PSBName details for the latest monitor in the TESTPROF profile, :

  - `zowe mat monitor imsview psbname --profile TESTPROF`

### zowe › mat › monitor › imsview › region

Get the IMS View Region details for the measurement.

#### Usage

zowe mat monitor imsview region [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the IMS View Region details for monitor number 5:

  - `zowe mat monitor imsview region --mon_num 5`

- Get the IMS View Region details for the latest monitor in the TESTPROF profile, :

  - `zowe mat monitor imsview region --profile TESTPROF`

### zowe › mat › monitor › imsview › ssa

Get the IMS View SSA details for the measurement.

#### Usage

zowe mat monitor imsview ssa [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--call` (string)

  - Specifies the call details for the specified monitor number or profile name.

- `--dbdname` (string)

  - Specifies the dbdname details for the specified monitor number or profile name.

- `--psbname` (string)

  - Specifies the psbname details for the specified monitor number or profile name.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the IMS details for monitor number 5, with the specific MAT profile details defined:

  - `zowe mat monitor imsview ssa --mon_num 5 --call TESTCALL --dbdname TESTDBDNAME --psbname TESTPSBNAME`

- Get the IMS View SSA details for the latest monitor in the TESTPROF profile,with the specific MAT profile details defined :

  - `zowe mat monitor imsview ssa --profile TESTPROF --call TESTCALL --dbdname TESTDBDNAME --psbname TESTPSBNAME`

- Get the IMS View SSA details for monitor number 5, with the specific MAT profile details defined:

  - `zowe mat monitor imsview ssa --mon_num 5 --call TESTCALL --dbdname TESTDBDNAME --psbname TESTPSBNAME`

### zowe › mat › monitor › imsview › statement

Get the IMS View Statement details for the measurement.

#### Usage

zowe mat monitor imsview statement [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--trancode` (string)

  - Specifies the trancode for specified monitor number or profile name

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the IMS View Statement details for monitor number 5with trancode TESTTRANCODE:

  - `zowe mat monitor imsview statement --mon_num 5 --trancode TESTTRANCODE`

- Get the IMS View Statement details for the latest monitor in the TESTPROF profile, with trancode TESTTRANCODE:

  - `zowe mat monitor imsview statement --profile TESTPROF --trancode TESTTRANCODE`

### zowe › mat › monitor › overview

Get the overview details of the measurement.

#### Usage

zowe mat monitor overview [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the overview details of the measurement for monitor number 5:

  - `zowe mat monitor overview --mon_num 5`

- Get the overview details of the measurement for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor overview --profile TESTPROF`

- Get the measurement overview details for monitor number 5, with the specific MAT profile details defined:

  - `zowe mat monitor overview --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty`

## zowe › mat › monitor › tranview

Get the TranView measurement details.

### zowe › mat › monitor › tranview › all

Get the CodeView measurement details in Module mode.

#### Usage

zowe mat monitor tranview all [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--tran` (string)

  - Specifies the histogram group size parameter that defines the resolution of the histogram (e.g., --group 32). If you do not specify the group parameter, the group size value defaults to 4 bytes. If the source program listing is registered with MAT, the group size parameter is ignored. The --group parameter is optional. Lower values of the --group parameter result in more granular representation of the histogram data. Values: numbers between 2 and 999999.

- `--type` (string)

  - Specifies the histogram group size parameter that defines the resolution of the histogram (e.g., --group 32). If you do not specify the group parameter, the group size value defaults to 4 bytes. If the source program listing is registered with MAT, the group size parameter is ignored. The --group parameter is optional. Lower values of the --group parameter result in more granular representation of the histogram data. Values: numbers between 2 and 999999.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the CodeView measurement details in Module mode for monitor number 5:

  - `zowe mat monitor tranview all --mon_num 5`

- Get the CodeView measurement details in Module mode for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor tranview all --profile TESTPROF`

### zowe › mat › monitor › tranview › callerid

Get the CodeView measurement details in Module mode.

#### Usage

zowe mat monitor tranview callerid [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--tran` (string)

  - Specifies the histogram group size parameter that defines the resolution of the histogram (e.g., --group 32). If you do not specify the group parameter, the group size value defaults to 4 bytes. If the source program listing is registered with MAT, the group size parameter is ignored. The --group parameter is optional. Lower values of the --group parameter result in more granular representation of the histogram data. Values: numbers between 2 and 999999.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the CodeView measurement details in Module mode for monitor number 5:

  - `zowe mat monitor tranview callerid --mon_num 5`

- Get the CodeView measurement details in Module mode for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor tranview callerid --profile TESTPROF`

### zowe › mat › monitor › tranview › callstack

Get the CodeView measurement details in Module mode.

#### Usage

zowe mat monitor tranview callstack [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--tran` (string)

  - Specifies the histogram group size parameter that defines the resolution of the histogram (e.g., --group 32). If you do not specify the group parameter, the group size value defaults to 4 bytes. If the source program listing is registered with MAT, the group size parameter is ignored. The --group parameter is optional. Lower values of the --group parameter result in more granular representation of the histogram data. Values: numbers between 2 and 999999.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the CodeView measurement details in Module mode for monitor number 5:

  - `zowe mat monitor tranview callstack --mon_num 5`

- Get the CodeView measurement details in Module mode for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor tranview callstack --profile TESTPROF`

### zowe › mat › monitor › tranview › csect

Get the CodeView measurement details in Csect mode.

#### Usage

zowe mat monitor tranview csect [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--tran` (string)

  - Specifies the unique monitor number of the measurement.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the CodeView measurement details in Csect mode for monitor number 5:

  - `zowe mat monitor tranview csect --mon_num 5`

- Get the CodeView measurement details in Csect mode for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor tranview csect --profile TESTPROF`

- Get the CodeView measurement details in Csect mode for monitor number 5, with the specific MAT profile details defined:

  - `zowe mat monitor tranview csect --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty`

### zowe › mat › monitor › tranview › delay

Get the delay details for the measurement.

#### Usage

zowe mat monitor tranview delay [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--tran` (string)

  - Specifies the unique monitor number of the measurement.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the DelayView measurement details for monitor number 5:

  - `zowe mat monitor tranview delay --mon_num 5`

- Get the DelayView measurement details for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor tranview delay --profile TESTPROF`

- Get the DelayView measurement details for monitor number 5, with the specific MAT profile details defined:

  - `zowe mat monitor tranview delay --mon_num 5 --host "example.com" --port 12345 --user johndoe --password qwerty`

### zowe › mat › monitor › tranview › module

Get the CodeView measurement details in Module mode.

#### Usage

zowe mat monitor tranview module [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--tran` (string)

  - Specifies the transaction of the measurement.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the Tranview measurement details in Module mode for monitor number 5:

  - `zowe mat monitor tranview module --mon_num 5`

- Get the Tranview measurement details in Module mode for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor tranview module --profile TESTPROF`

- Get the Tranview measurement details in Module mode for transaction number MVGT, with the specific MAT profile details defined:

  - `zowe mat monitor tranview module --tran MVGT`

### zowe › mat › monitor › tranview › stat

Get the CodeView measurement details in Module mode.

#### Usage

zowe mat monitor tranview stat [options]

#### Options

- `--profile` (string)

  - Specifies the name of the profile that you want to analyze. When you specify the profile name, you get the data for the latest measurement within the specified profile.

- `--mon_num` (number)

  - Specifies the unique monitor number of the measurement.

- `--tran` (string)

  - Specifies the histogram group size parameter that defines the resolution of the histogram (e.g., --group 32). If you do not specify the group parameter, the group size value defaults to 4 bytes. If the source program listing is registered with MAT, the group size parameter is ignored. The --group parameter is optional. Lower values of the --group parameter result in more granular representation of the histogram data. Values: numbers between 2 and 999999.

- `--type` (string)

  - Specifies the histogram group size parameter that defines the resolution of the histogram (e.g., --group 32). If you do not specify the group parameter, the group size value defaults to 4 bytes. If the source program listing is registered with MAT, the group size parameter is ignored. The --group parameter is optional. Lower values of the --group parameter result in more granular representation of the histogram data. Values: numbers between 2 and 999999.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Get the CodeView measurement details in Module mode for monitor number 5:

  - `zowe mat monitor tranview stat --mon_num 5`

- Get the CodeView measurement details in Module mode for the latest monitor in the TESTPROF profile:

  - `zowe mat monitor tranview stat --profile TESTPROF`

## zowe › mat › profile

Create, invoke, and list MAT monitor profiles.

### zowe › mat › profile › create

Create a MAT monitor profile.

#### Usage

zowe mat profile create [options]

#### Required Options

- `--profile` (string)

  - Specifies the name of the profile that you create in MAT (e.g. PROFILE1). Values: 1 to 8 characters, a combination of alphanumeric and national characters (A-Z, 0-9, and @), the first character must be an alphabetic or @. The profile name must not contain characters # and $.

- `--jobname` (string)

  - Specifies the name of the job that you want to measure (e.g. JOB1). Values: 1 to 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).

- `--targsys` (string)

  - Specifies the target system in SYSPLEX. Values: a comma separated list of up to 4 values is allowed, 1-8 characters each, a combination of alphanumeric (A-Z and 0-9) and national (@,#,$), the first character must be an alphabetic (A-Z) or a national (@, #, $), e.g. AA31,AA32).

#### Options

- `--batchreports` (string)

  - Specifies the setting for the Batch report option upon monitor completion.

    Default value: no
    Allowed values: yes, no

- `--description` (string)

  - Provide the monitor description (maximum 24 characters).

- `--mondsn` (string)

  - Specifies the monitor data set name where MAT saves the measurement (e.g. DEMO.MAT.MONITOR). Values: data set name pattern, maximum 46 characters. If not specified, your default MAT monitor DSN pattern is applied.

- `--stepname` (string)

  - Specifies the name of the job step to monitor. Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).

- `--mstep` (string)

  - Indicates whether the multi-step monitoring option is enabled.

    Default value: no
    Allowed values: yes, no

- `--procstep` (string)

  - Specifies the name of the procedure step. Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).

- `--program` (string)

  - Specifies the name of the program to monitor. Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).

- `--elapstime` (string)

  - Specifies the required monitor duration followed by s (seconds) or m (minutes) (e.g. 60s). Values: maximum 6 characters total, number must be > 0.

    Default value: 60s

- `--smon` (string)

  - Specifies whether to monitor the entire step.

    Default value: no
    Allowed values: yes, no

- `--tasklib` (string)

  - Specifies an additional DD name for load modules. Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).

- `--samplecnt` (string)

  - Specifies the number of observations requested. Values: maximum 6 characters, numbers between 10 and 999999.

    Default value: 6000

- `--succnt` (string)

  - Specifies the maximum number of monitors to run per job execution. Values: maximum 4 characters, numbers between 1 and 9999.

    Default value: 1

- `--reccnt` (string)

  - Specifies the number of times this job step will be monitored. Values: maximum 4 characters, numbers between 1 and 9999.

    Default value: 1

- `--sampdelay` (string)

  - Specifies the delay monitoring time in seconds after the step start. Values: maximum 4 characters, numbers between 0 and 9999.

    Default value: 0

- `--userexit1` (string)

  - Specifies the name for the call user written Data Base. Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. DBEXIT1).

- `--userexit2` (string)

  - Specifies the name 1 for the call user written 4GL exit programs for this monitor . Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. UEXIT1).

- `--userexit3` (string)

  - Specifies the name 2 for the call user written 4GL exit programs for this monitor . Values: maximum 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. UEXIT2).

- `--inctask` (string)

  - Specifies the task name to define the tasks that you want to sample in a multitasking environment and restrict monitoring to the specific subtask within the address space. Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. INC31,INC32).

- `--exctask` (string)

  - Specifies the task name to omit from sampling in a multitasking environment Values: a comma separated list of up to 4 values is allowed, max. 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %) (e.g. EXC31,EXC32).

- `--tran` (string)

  - Specifies the CICS transaction code name to monitor .Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or +) (e.g. TRAN1,TRAN2).

- `--term` (string)

  - Specifies the CICS terminal IDs to monitor. Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or +) (e.g. TERM1,TERM2).

- `--userid` (string)

  - Specifies the CICS user IDs to monitor. Values: Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or +) (e.g. USER1,USER2).

- `--db2expl` (string)

  - Indicates whether the Explain SQL option is enabled for DB2 SQL statements.

    Default value: no
    Allowed values: yes, no

- `--db2ctsql` (string)

  - Indicates whether the Collect SQL from Catalog option is enabled for DB2 SQL statements.If you specify db2expl=yes, then db2ctsql must be also set to yes.

    Default value: no
    Allowed values: yes, no

- `--db2hvloc` (string)

  - Indicates whether the Requestor Location option is enabled for DB2 measurements.

    Default value: no
    Allowed values: yes, no

- `--db2hvcor` (string)

  - Indicates whether the Correlation ID option for SQL statements is enabled for DB2 measurements.

    Default value: no
    Allowed values: yes, no

- `--db2hviid` (string)

  - Indicates whether the Operator ID option for SQL statements is enabled for DB2 measurements.

    Default value: no
    Allowed values: yes, no

- `--db2hvthd` (string)

  - Indicates whether the Thread Address option for SQL statements is enabled for DB2 measurements.

    Default value: no
    Allowed values: yes, no

- `--wasexprt` (string)

  - Indicates whether the Expert Mode is enabled for Java measurement.

    Default value: no
    Allowed values: yes, no

- `--urlfilt` (string)

  - A filtering string to restrict monitoring to the specific application URL, transaction, or stored procedure for Java measurements. Values: a comma separated list of up to 4 values is allowed, max. 64 characters (e.g. mypage1.html,mypage2.html).

- `--sysfilt` (string)

  - A filtering string to include the specified system class for Java measurements. If you specify a value for sysfilt, the measurement includes only the classes that match the filtering string pattern. Values: a comma separated list of up to 3 values is allowed, max. 64 characters (e.g. user1.class,user2.class).

- `--schedule` (string)

  - Specifies the name of the schedule that you want to apply to the monitor profile (maximum 8 characters).

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Create the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system:

  - `zowe mat profile create --profile PROFILE1 --jobname JOB1 --targsys AA31`

- Create the PROFILE1 monitor profile to measure for 90 seconds job JOB1 that runs on the AA31 and AA32 systems:

  - `zowe mat profile create --profile PROFILE1 --jobname JOB1 --targsys AA31,AA32 --elapstime 90s`

- Create the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system, with the specific MAT profile details defined:

  - `zowe mat profile create --profile PROFILE1 --jobname JOB1 --targsys AA31 --host "example.com" --port 12345 --user johndoe --password qwerty`

### zowe › mat › profile › invoke

Invoke a MAT monitor profile to start measurement.

#### Usage

zowe mat profile invoke [options]

#### Required Options

- `--profile` (string)

  - Specifies the name of the profile in MAT that you invoke (e.g. PROFILE1). Values: 1 to 8 characters, a combination of alphanumeric and national characters (A-Z, 0-9, and @), the first character must be an alphabetic or @. The profile name must not contain characters # and $.

- `--jobname` (string)

  - Specifies the name of the job to be measured (e.g. JOB1). Values: 1 to 8 characters, alphanumeric (A-Z capitals only and 0-9), national (#, $, @), and wildcards (* or %).

- `--targsys` (string)

  - Specifies the target system in SYSPLEX. Values: a comma separated list of up to 4 values is allowed, maximum 8 characters each, a combination of alphanumeric (A-Z and 0-9) and national (@,#,$), the first character must be an alphabetic (A-Z) or a national (@, #, $) (e.g. AA31,AA32).

#### Options

- `--mondsn` (string)

  - Specifies the monitor data set name where MAT saves the measurement (e.g. DEMO.MAT.MONITOR). Values: data set name pattern, maximum 46 characters. If not specified, your default MAT monitor DSN pattern is applied.

- `--moiuuid` (string)

  - Specifies the MOI UUID. Values: maximum 61 characters, alphanumeric (A-Z and 0-9). If you use this parameter for command execution, the value cannot be blank.

- `--moitimestamp` (string)

  - Specifies the MOI timestamp. Values: maximum 12 characters, numbers only (0-9). If you use this parameter for command execution, the value cannot be blank.

- `--listing` (boolean)

  - Activates automated registration of Cobol, C/C++, and Assembler program listings through Endevor® footprints. After completion of the measurement that you invoke with the --listing parameter, the MAT Analyze plug-in for Zowe CLI automatically retrieves the program listing that is associated with the monitored job and registers the listing with MAT. A registered program listing enhances the analysis possibilities of the 'codeview histogram' command the 'codeview histogram' command and enables you to inspect the source code statements that are associated with specific modules and CSECTs.

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

- Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system :

  - `zowe mat profile invoke --profile PROFILE1 --jobname JOB1 --targsys AA31`

- Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system and save the measurement result in the DEMO.MAT.MONITOR.PROFILE1 data set:

  - `zowe mat profile invoke --profile PROFILE1 --jobname JOB1 --targsys AA31 --mondsn DEMO.MAT.MONITOR.PROFILE1`

- Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system and register the program listing:

  - `zowe mat profile invoke --profile PROFILE1 --jobname JOB1 --targsys AA31 --listing`

- Invoke the PROFILE1 monitor profile to measure job JOB1 that runs on the AA31 system with the specific MAT profile details defined:

  - `zowe mat profile invoke --profile PROFILE1 --jobname JOB1 --targsys AA31 --host "example.com" --port 12345 --user johndoe --password qwerty`

### zowe › mat › profile › list

Get the list of available monitor profiles.

#### Usage

zowe mat profile list [options]

#### MAT Profile Options

- `--protocol` | `-o` (string)

  - Specifies the protocol defined for the MAT REST API server (http or https).

    Default value: https
    Allowed values: http, https

- `--host` | `-H` (string)

  - Specifies the hostname or IP address defined for the MAT REST API server (e.g. 127.0.0.0 or localhost).

- `--port` | `-P` (number)

  - Specifies the server port (e.g. 8080).

- `--user` | `-u` (string)

  - Your mainframe username.

- `--password` | `--pw` (string)

  - Your mainframe password.

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--listingDir` | `--ldir` (string)

  - Specifies the directory where you want to store the registered program listings (e.g. 'c:\listings') for your immediate source code inspection. You can use the advantage of automated listing registration with MAT and listing retrieval through Endevor® footprints for Cobol, C/C++, and Assembler programs. When a source program listing is registered with MAT, you can enhance the histogram analysis data with the program listing details that pertain to the specific CSECT and program statement. The listing is transfered to the specified directory, which enables you to navigate directly to the line of the source code in you VS Code IDE and inspect the program statement. To use the listing retrieval option through Endevor® footprints, you need to have the Endevor® Web Services installed and configured and specify the Endevor® web server details in the MAT database configuration.

#### Profile Options

- `--mat-profile` | `--mat-p` (string)

  - The name of a (mat) 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

- `--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

## zowe › mat-pma-util

The MAT Detect plug-in for Zowe CLI enables you to detect performance issues and access performance data supplied by the Performance Management Assistant component (PMA) of Mainframe Application Tuner.

## zowe › mat-pma-util › get

Get performance information using PMA utilities. You can get the current performance data of your jobs and check for the daily performance alerts.

### zowe › mat-pma-util › get › alert

Check for alerts created in PMA and detect whether any of your jobs exceeds the average daily performance. If the threshold is exceeded, a PMA alert is triggered. We recommend that you include this command in your end-of-day build to trace all jobs that might cause performance degradation by code changes during the day.

#### Usage

zowe mat-pma-util get alert [options]

#### 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

- Check whether any of your jobs exceeds the average daily performance using the default profile:

  - `zowe mat-pma-util get alert`

- Check whether any of your jobs exceeds the average daily performance using specific PMA profile details:

  - `zowe mat-pma-util get alert --ja 123456789 --jc A --jmc A --jl HLQ.CEETLOAD --jph PMAHLQ`

### zowe › mat-pma-util › get › alert-by-job

Check whether the specified job exceeds the average daily performance. No record returned indicates that no performance degradation was detected for this job.

#### Usage

zowe mat-pma-util get alert-by-job <jobname> [options]

#### Positional Arguments

- `jobname` (string)

  - Specifies the name of the job that is being tested (e.g. TESTPMA8).

#### 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

- Check whether your job TESTPMA8 exceeds the average daily performance using the default profile:

  - `zowe mat-pma-util get alert-by-job TESTPMA8`

- Check whether your job TESTPMA8 exceeds the average daily performance using specific PMA profile details:

  - `zowe mat-pma-util get alert-by-job TESTPMA8 --ja 123456789 --jc A --jmc A --jl HLQ.CEETLOAD --jph PMAHLQ`

### zowe › mat-pma-util › get › perf

Get the current performance data of a specific job using PMA. If the current measurement results for any of the measured parameters are higher than average values, an alert message is displayed.

#### Usage

zowe mat-pma-util get perf <jobname> [options]

#### Positional Arguments

- `jobname` (string)

  - Specifies the name of the job that is being tested (e.g. TESTPMA8).

#### 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

- Get the current performance data of the TESTPMA8 job using the default profile:

  - `zowe mat-pma-util get perf TESTPMA8`

- Get the current performance data of the TESTPMA8 job using specific PMA profile details:

  - `zowe mat-pma-util get perf TESTPMA8 --ja 123456789 --jc A --jmc A --jl HLQ.CEETLOAD --jph PMAHLQ`

## zowe › mat-pma-util › scope

Get and define the PMA scope information. You can create and update the list of jobs that you want to include, or the list of programs to be excluded from the PMA scope of work.

### zowe › mat-pma-util › scope › del-job

Delete a job from the list of inclusions in the PMA scope.

#### Usage

zowe mat-pma-util scope del-job <jobname> [options]

#### Positional Arguments

- `jobname` (string)

  - Specifies the name of the job that you want to delete from 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 delete from the list of inclusions in the PMA scope.

- `--procstep` | `--ps` (string)

  - Specifies the procname of the job that you want to delete from the list of inclusions 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.

    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

- Delete the TESTPMA8 job from the list of inclusions in the PMA scope:

  - `zowe mat-pma-util scope del-job TESTPMA8`

- Delete the specific procname and step name of the TESTPMA8 job from the list of inclusions in the PMA scope:

  - `zowe mat-pma-util scope del-job TESTPMA8 --ps TESTCALL --st TESTDO`

- Delete the specific procname and step name of the TESTPMA8 job from the list of inclusions in the PMA scope using specific PMA profile details:

  - `zowe mat-pma-util scope del-job TESTPMA8 --ps TESTCALL --st TESTDO --ja 123456789 --jc A --jmc A --jl HLQ.CEETLOAD --jph PMAHLQ`

### zowe › mat-pma-util › scope › del-pgm

Delete a program from the list of exclusions from the PMA scope.

#### Usage

zowe mat-pma-util scope del-pgm <pgmname> [options]

#### Positional Arguments

- `pgmname` (string)

  - Specifies the name of the program that you want to delete from the list of exclusions from the PMA scope (e.g. TESTPMA8).

#### 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

- Delete the TESTPMA8 program from the exclusions list from the PMA scope:

  - `zowe mat-pma-util scope del-pgm TESTPMA8`

- Delete the TESTPMA8 program from the exclusions list from the PMA scope using specific PMA profile details:

  - `zowe mat-pma-util scope del-pgm TESTPMA8 --ja 123456789 --jc A --jmc A --jl HLQ.CEETLOAD --jph PMAHLQ`

### 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`

### zowe › mat-pma-util › scope › get-listj

Get the list of jobs included in the PMA scope.

#### Usage

zowe mat-pma-util scope get-listj [options]

#### 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

- Get the list of jobs included in the PMA scope:

  - `zowe mat-pma-util scope get-listj`

- Get the list of jobs included in the PMA scope using specific PMA profile details:

  - `zowe mat-pma-util scope get-listj --ja 123456789 --jc A --jmc A --jl HLQ.CEETLOAD --jph PMAHLQ`

### zowe › mat-pma-util › scope › get-listp

Get the list of programs excluded from the PMA scope.

#### Usage

zowe mat-pma-util scope get-listp [options]

#### 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

- Get the list of programs excluded from the PMA scope:

  - `zowe mat-pma-util scope get-listp`

- Get the list of programs excluded from the PMA scope using specific PMA profile details:

  - `zowe mat-pma-util scope get-listp --ja 123456789 --jc A --jmc A --jl HLQ.CEETLOAD --jph PMAHLQ`

### 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.

    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

- 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`

## zowe › mq

Interact with IBM MQ for z/OS.

## zowe › mq › run

MQ Utilities

### zowe › mq › run › mqsc

MQ Utilities

#### Usage

zowe mq run mqsc <qmgr> <cmd> [options]

#### Positional Arguments

- `qmgr` (string)

  - The queue manager to apply the command to

- `cmd` (string)

  - The MQSC command

#### MQ Connection Options

- `--host` | `-H` (string)

  - The host name used to access the IBM MQ REST API. This might be the host name of the IBM MQ mqweb server, or the Zowe API Mediation Layer..

- `--port` | `-P` (number)

  - The port number used to access the IBM MQ REST API. This might be the port number of the IBM MQ mqweb server, or the Zowe API Mediation Layer.

- `--user` | `-u` (string)

  - The mainframe (MQ) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - The mainframe (MQ) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: false

- `--protocol` (string)

  - Specifies the MQ protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--mq-profile` | `--mq-p` (string)

  - The name of a (mq) 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

- `--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

- The following sequence shows how to query a server-connection channel that is called NEWSVRCONN on an MQ queue manager - our example queue manager is called MQ99:

  - `zowe mq run mqsc MQ99 "DISPLAY CHANNEL(NEWSVRCONN)"`

## zowe › omspool

Interact with Output Management Spool™ for z/OS (OM Spool)

## zowe › omspool › issue

Issue OM Spool commands.

### zowe › omspool › issue › command

Issue commands to work with OM Spool.

#### Usage

zowe omspool issue command <command-text> [options]

#### Positional Arguments

- `command-text` (string)

  - The OM Spool command to issue.

#### OM SPOOL OPTIONS

- `--account` | `-a` (string)

  - z/OS TSO/E accounting information.

- `--spoolhlq` | `--hlq` (string)

  - High level qualifier of OM Spool installation.

- `--subsys` | `--sub` (string)

  - OM Spool subsystem name.

    Default value: ESF

- `--outds` | `--out` (string)

  - The SYSTSPRT data set allocated by CAI.CBQ4JCL(BQ4JZOWE). It must be unique for each Zowe CLI user interacting with OM Spool.

- `--clist` | `--cl` (string)

  - The data set containing ESFZOWE REXX exec.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--omspool-profile` | `--omspool-p` (string)

  - The name of a (omspool) profile to load for this command execution.

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Issue the OM Spool command 'DS' to display the status of the ESF system:

  - `zowe omspool issue command "DS"`

## zowe › omview

Access Output Management View™ for z/OS data and perform related tasks.

## zowe › omview › download

Download OM View report data to local folder.

### zowe › omview › download › report

Download report data.
Optionally convert text report to PDF.

#### Usage

zowe omview download report <repositoryId> <reportHandle> [fileTarget] [options]

#### Positional Arguments

- `repositoryId` (number)

  - Repository identifier.

- `reportHandle` (string)

  - Report handle.

- `fileTarget` (string)

  - Local file path.
    If the path represents a directory location, the report will be downloaded into that directory using a default file name.
    If the path does not represent a directory location, the report will be downloaded into the specified path.
    If the path is not specified, the file will be saved to the current working directory using the default file name.
    Any missing directories will be created. If the target file already exists, the file will be overwritten.

#### Options

- `--convert-to-pdf` | `--to-pdf` (boolean)

  - Converts text report to PDF.

    Default value: false

- `--page-orientation` | `--orientation` (string)

  - Page orientation for converted PDF.

    Default value: PORTRAIT
    Allowed values: PORTRAIT, LANDSCAPE

- `--font-size` | `--font` (number)

  - Font size for converted PDF.

    Default value: 12

- `--green-bar` (boolean)

  - Include green-bar background in converted PDF.

    Default value: false

- `--pages` (string)

  - Include the specified page numbers (or page ranges). Separate page numbers (or page ranges) with commas.
    Separate boundaries of a page range with a dash (-). If you do not specify this option, all the pages of the report are downloaded.

    Allowed values: (\d+(-\d+)?)(,(\d+(-\d+)?))*

- `--content-filter` | `--filter` (string)

  - Filter text report content using a permanent filter definition.
    If the product instance does not support this feature, this option is ignored.

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

## zowe › omview › export

Export OM View text report file to local folder.

### zowe › omview › export › report

Export text report to spreadsheet using a predefined export rule.

#### Usage

zowe omview export report <repositoryId> <reportHandle> <ruleId> [fileTarget] [options]

#### Positional Arguments

- `repositoryId` (number)

  - Repository identifier.

- `reportHandle` (string)

  - Report handle.

- `ruleId` (number)

  - Export rule identifier.

- `fileTarget` (string)

  - Local file path.
    If the path represents a directory location, the report will be exported into that directory using a default file name.
    If the path does not represent a directory location, the report will be exported into the specified path.
    If the path is not specified, the file will be saved to the current working directory using the default file name.
    Any missing directories will be created. If the target file already exists, the file will be overwritten.

#### Options

- `--pages` (string)

  - Include the specified page numbers (or page ranges). Separate page numbers (or page ranges) with commas.
    Separate boundaries of a page range with a dash (-). If you do not specify this option, all the pages of the report are exported.

    Allowed values: (\d+(-\d+)?)(,(\d+(-\d+)?))*

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

## zowe › omview › get

Get information from OM View repository.

## zowe › omview › get › user

Get user information from repository.

### zowe › omview › get › user › settings

Get current user settings from repository.

#### Usage

zowe omview get user settings <repositoryId> [options]

#### Positional Arguments

- `repositoryId` (number)

  - Repository identifier.

#### Options

- `--output-format` | `--output` (string)

  - Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: tabular, csv, json, xml

- `--output-header` | `--header` (boolean)

  - Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

- `--output-field` | `-f` (array)

  - Field to include in the output. Multiple fields can be specified. Fields appear in the order you specify.

    Default value: Mode,DistId,ModeAccess,DistMask
    Allowed values: Mode, DistId, ModeAccess, DistMask, Banner, Language, MasterAuthority, Printer, UserId

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

## zowe › omview › list

List OM View repository, report, and user information.

### zowe › omview › list › export-rules

List export rules defined for a report.
Use the returned 'Identifier' in the 'export report' command to reference that rule.

#### Usage

zowe omview list export-rules <reportId> [options]

#### Positional Arguments

- `reportId` (string)

  - Report ID (Name).

#### Options

- `--output-format` | `--output` (string)

  - Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: tabular, csv, json, xml

- `--output-header` | `--header` (boolean)

  - Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

- `--output-field` | `-f` (array)

  - Field to include in the output. Multiple fields can be specified. Fields appear in the order you specify.

    Default value: Identifier,Name,Description
    Allowed values: Identifier, Name, Description, Owner, Public

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

## zowe › omview › list › report

List information about a specific report.

### zowe › omview › list › report › index-names

List indexes for a a specific report.
Use the returned 'IndexNameHandle' to reference a report index.
Use the returned 'IndexNameHandle' in the 'list report index-values' command to retrieve the list of associated index values for that index.

#### Usage

zowe omview list report index-names <repositoryId> <reportHandle> [options]

#### Positional Arguments

- `repositoryId` (number)

  - Repository identifier.

- `reportHandle` (string)

  - Report handle.

#### Options

- `--filter-names` | `--names` (string)

  - Filter (include) based on index name. Separate multiple index names with commas. Use the asterisk (*) as a wildcard to represent any number of characters.

    Default value: *,*,*,*,*,*,*,*

- `--output-format` | `--output` (string)

  - Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: tabular, csv, json, xml

- `--output-header` | `--header` (boolean)

  - Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

- `--output-field` | `-f` (array)

  - Field to include in the output. Multiple fields can be specified. Fields appear in the order you specify.

    Default value: Index,SubIndexNames,IndexNameHandle
    Allowed values: Index, SubIndexNames, IndexNameHandle

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

### zowe › omview › list › report › index-values

List index values for a report index.
Use the returned 'ReportHandle' to reference an index value in other commands.
For example, use 'ReportHandle' in the 'download report' command to download that corresponding view of the report.

#### Usage

zowe omview list report index-values <repositoryId> <reportHandle> <indexNameHandle> [options]

#### Positional Arguments

- `repositoryId` (number)

  - Repository identifier.

- `reportHandle` (string)

  - Report handle.

- `indexNameHandle` (string)

  - Index name handle.

#### Options

- `--filter-values` | `--values` (string)

  - Filter (include) based on index values. Separate index values with commas. Use the asterisk (*) as a wildcard to represent any number of characters.

    Default value: *,*,*,*,*,*,*,*

- `--output-format` | `--output` (string)

  - Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: tabular, csv, json, xml

- `--output-header` | `--header` (boolean)

  - Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

- `--output-field` | `-f` (array)

  - Field to include in the output. Multiple fields can be specified. Fields appear in the order you specify.

    Default value: Value,SubValues,ReportHandle
    Allowed values: Value, SubValues, ReportHandle

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

### zowe › omview › list › report › logical-views

List logical views available for a specific report.
Use the returned 'ReportHandle' to reference a logical view in other commands.
For example, use 'ReportHandle' in the 'download report' command to download the logical view of that report.
Use the returned 'IndexNameHandle' in the 'list report index-values' command to retrieve the list of associated index values (if defined) for that index.

#### Usage

zowe omview list report logical-views <repositoryId> <reportHandle> [options]

#### Positional Arguments

- `repositoryId` (number)

  - Repository identifier.

- `reportHandle` (string)

  - Report handle.

#### Options

- `--output-format` | `--output` (string)

  - Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: tabular, csv, json, xml

- `--output-header` | `--header` (boolean)

  - Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

- `--output-field` | `-f` (array)

  - Field to include in the output. Multiple fields can be specified. Fields appear in the order you specify.

    Default value: Description,Index,SubIndexNames,ReportHandle,IndexNameHandle
    Allowed values: Description, Index, SubIndexNames, ReportHandle, IndexNameHandle, Number, ViewId, Default

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

### zowe › omview › list › reports

List reports in a repository.
Use the returned 'ReportHandle' to reference a report in other commands.
For example, use the 'ReportHandle' in the 'download report' command to download that report.

#### Usage

zowe omview list reports <repositoryId> [options]

#### Positional Arguments

- `repositoryId` (number)

  - Repository identifier.

#### Options

- `--filter-name` | `-n` (string)

  - Filter (include) based on report name. Use the asterisk (*) as a wildcard to represent any number of characters.

    Default value: *

- `--limit` | `-l` (number)

  - Limit (maximum number) of retrieved records.

    Default value: 1000

- `--latest-versions` | `--latest-version` | `--lv` (number)

  - Number of latest versions (of reports) to include. If not specified, all versions of reports are included.

    Default value: 0

- `--archival-since` | `--since` | `--archival-from` | `--from` (string)

  - Date of earliest archived reports to include based on archival date. Specify a value in the ISO-8601 format.

- `--archival-until` | `--until` | `--archival-to` | `--to` (string)

  - Date of latest archived reports to include based on archival date. Specify a value in the ISO-8601 format.

- `--output-header` | `--header` (boolean)

  - Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

- `--output-format` | `--output` (string)

  - Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: tabular, csv, json, xml

- `--output-field` | `-f` (array)

  - Field to include in the output. Multiple fields can be specified. Fields appear in the order you specify.

    Default value: ReportName,Lines,Pages,Type,ArchivalDate,Description,UserComments,ReportHandle
    Allowed values: ReportName, Lines, Pages, Type, ArchivalDate, Description, UserComments, ReportHandle, TotalPages, OriginalType, Destination, JobName, Origin, Generation, SequenceNumber, SysoutClass, Status, JobID, Forms, XCode, UserID, ReadDate, PrintDate, OnDisk, OnTape, OnOptical, IndexOnDisk, Location, TapeSequence, TapePosition, TapeCount, ExtendedRetentionOptionID, RemainingDays, RemainingGenerations, RemainingCopy, RemainingDiskDays, RemainingDiskGeneration, RemainingDiskCopy, RemainingDisk2days

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

### zowe › omview › list › repositories

List repositories.
Use the returned 'Identifier' to reference a repository in other commands.
For example, use the 'Identifier' in the list reports' command to list reports in that repository.

#### Usage

zowe omview list repositories [options]

#### Options

- `--filter-name` | `-n` (string)

  - Filter (include) based on repository name. Use the question mark (?) as a wildcard to represent a single character. Use the asterisk (*) as a wildcard to represent any number of characters.

- `--filter-path` | `-p` (string)

  - Filter (include) based on repository path. Use the percent sign (%) as a wildcard to represent a single character. Use the asterisk (*) as a wildcard to represent any number of characters.

    Default value: *

- `--output-format` | `--output` (string)

  - Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: tabular, csv, json, xml

- `--output-header` | `--header` (boolean)

  - Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

- `--output-field` | `-f` (array)

  - Field to include in the output. Multiple fields can be specified. Fields appear in the order you specify.

    Default value: Identifier,Name,Description,Path,CharacterSet
    Allowed values: Identifier, Name, Description, Path, CharacterSet, ReportAccess, CreatedBy, DateCreated, ModifiedBy, ModifiedDate

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

## zowe › omview › search

Search data in a OM View repository.

## zowe › omview › search › index

Search cross-report index data in a repository.

### zowe › omview › search › index › names

Search cross-report index names in a repository.
Use the returned 'IndexNameHandle' to reference a cross-report index name.
For example, use the 'IndexNameHandle' in the 'search index values' command to retrieve the list of index values for that cross-report index.

#### Usage

zowe omview search index names <repositoryId> [options]

#### Positional Arguments

- `repositoryId` (number)

  - Repository identifier.

#### Options

- `--filter-reports` | `--reports` (string)

  - Filter (include) based on report names (IDs). Use the asterisk (*) as a wildcard to represent any number of characters.

    Default value: *

- `--filter-names` | `--names` (string)

  - Filter (include) based on index name. Separate multiple index names with commas. Use the asterisk (*) as a wildcard to represent any number of characters.

    Default value: *,*,*,*,*,*,*,*

- `--latest-versions` | `--latest-version` | `--lv` (number)

  - Number of latest versions (of reports) to include. If not specified, all versions of reports are included.

    Default value: 0

- `--archival-since` | `--since` | `--archival-from` | `--from` (string)

  - Date of earliest archived reports to include based on archival date. Specify a value in the ISO-8601 format.

- `--archival-until` | `--until` | `--archival-to` | `--to` (string)

  - Date of latest archived reports to include based on archival date. Specify a value in the ISO-8601 format.

- `--online-only` | `--online` (boolean)

  - Include only those reports that are available online.

    Default value: true

- `--output-format` | `--output` (string)

  - Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: tabular, csv, json, xml

- `--output-header` | `--header` (boolean)

  - Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

- `--output-field` | `-f` (array)

  - Field to include in the output. Multiple fields can be specified. Fields appear in the order you specify.

    Default value: Index,SubIndexNames,IndexNameHandle
    Allowed values: Index, SubIndexNames, IndexNameHandle

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

### zowe › omview › search › index › reports

Search reports containing a cross-report index value in a repository.
Use the returned 'ReportHandle' to reference a view of the report.
For example, use the 'ReportHandle' in the 'download report' command to download that view of the report.

#### Usage

zowe omview search index reports <repositoryId> <indexNameHandle> <valueHandle> [options]

#### Positional Arguments

- `repositoryId` (number)

  - Repository identifier.

- `indexNameHandle` (string)

  - Index name handle.

- `valueHandle` (string)

  - Index value handle.

#### Options

- `--filter-reports` | `--reports` (string)

  - Filter (include) based on report names (IDs). Use the asterisk (*) as a wildcard to represent any number of characters.

    Default value: *

- `--latest-versions` | `--latest-version` | `--lv` (number)

  - Number of latest versions (of reports) to include. If not specified, all versions of reports are included.

    Default value: 0

- `--archival-since` | `--since` | `--archival-from` | `--from` (string)

  - Date of earliest archived reports to include based on archival date. Specify a value in the ISO-8601 format.

- `--archival-until` | `--until` | `--archival-to` | `--to` (string)

  - Date of latest archived reports to include based on archival date. Specify a value in the ISO-8601 format.

- `--online-only` | `--online` (boolean)

  - Include only those reports that are available online.

    Default value: true

- `--output-format` | `--output` (string)

  - Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: tabular, csv, json, xml

- `--output-header` | `--header` (boolean)

  - Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

- `--output-field` | `-f` (array)

  - Field to include in the output. Multiple fields can be specified. Fields appear in the order you specify.

    Default value: ReportName,Lines,Pages,Type,ArchivalDate,Description,UserComments,ReportHandle
    Allowed values: ReportName, Lines, Pages, Type, ArchivalDate, Description, UserComments, ReportHandle, TotalPages, OriginalType, Destination, JobName, Origin, Generation, SequenceNumber, SysoutClass, Status, JobID, Forms, XCode, UserID, ReadDate, PrintDate, OnDisk, OnTape, OnOptical, IndexOnDisk, Location, TapeSequence, TapePosition, TapeCount, ExtendedRetentionOptionID, RemainingDays, RemainingGenerations, RemainingCopy, RemainingDiskDays, RemainingDiskGeneration, RemainingDiskCopy, RemainingDisk2days

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

### zowe › omview › search › index › values

Search cross-report index values in a repository.
Use the returned 'IndexValueHandle' in the 'search index reports' command to retrieve the list of reports containing that index value.

#### Usage

zowe omview search index values <repositoryId> <indexNameHandle> [options]

#### Positional Arguments

- `repositoryId` (number)

  - Repository identifier.

- `indexNameHandle` (string)

  - Index name handle.

#### Options

- `--filter-reports` | `--reports` (string)

  - Filter (include) based on report names (IDs). Use the asterisk (*) as a wildcard to represent any number of characters.

    Default value: *

- `--filter-values` | `--values` (string)

  - Filter (include) based on index values. Separate index values with commas. Use the asterisk (*) as a wildcard to represent any number of characters.

    Default value: *,*,*,*,*,*,*,*

- `--latest-versions` | `--latest-version` | `--lv` (number)

  - Number of latest versions (of reports) to include. If not specified, all versions of reports are included.

    Default value: 0

- `--archival-since` | `--since` | `--archival-from` | `--from` (string)

  - Date of earliest archived reports to include based on archival date. Specify a value in the ISO-8601 format.

- `--archival-until` | `--until` | `--archival-to` | `--to` (string)

  - Date of latest archived reports to include based on archival date. Specify a value in the ISO-8601 format.

- `--online-only` | `--online` (boolean)

  - Include only those reports that are available online.

    Default value: true

- `--output-format` | `--output` (string)

  - Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: tabular, csv, json, xml

- `--output-header` | `--header` (boolean)

  - Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

- `--output-field` | `-f` (array)

  - Field to include in the output. Multiple fields can be specified. Fields appear in the order you specify.

    Default value: Value,SubValues,IndexValueHandle
    Allowed values: Value, SubValues, IndexValueHandle

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

## zowe › omview › set

Set information in OM View repository.

## zowe › omview › set › user

Set configuration for current user in repository.

### zowe › omview › set › user › distribution

Set distribution id for current user in repository.

#### Usage

zowe omview set user distribution <repositoryId> <distributionId> [options]

#### Positional Arguments

- `repositoryId` (number)

  - Repository identifier.

- `distributionId` (string)

  - Distribution ID.

#### Options

- `--output-format` | `--output` (string)

  - Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: tabular, csv, json, xml

- `--output-header` | `--header` (boolean)

  - Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

- `--output-field` | `-f` (array)

  - Field to include in the output. Multiple fields can be specified. Fields appear in the order you specify.

    Default value: Mode,DistId,ModeAccess,DistMask
    Allowed values: Mode, DistId, ModeAccess, DistMask, Banner, Language, MasterAuthority, Printer, UserId

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

### zowe › omview › set › user › mode

Set mode for current user in repository.

#### Usage

zowe omview set user mode <repositoryId> <mode> [options]

#### Positional Arguments

- `repositoryId` (number)

  - Repository identifier.

- `mode` (string)

  - User mode.
    Must match regular expression: `^(ALL|SAR|SARO|EXP|EXPO)$`

#### Options

- `--output-format` | `--output` (string)

  - Output format. This option is ignored if '--response-format-json' is specified.

    Default value: tabular
    Allowed values: tabular, csv, json, xml

- `--output-header` | `--header` (boolean)

  - Include header with field names in the output when you specify 'tabular' or 'csv' for the output format.
    This option is ignored when you specify any other output format.

    Default value: true

- `--output-field` | `-f` (array)

  - Field to include in the output. Multiple fields can be specified. Fields appear in the order you specify.

    Default value: Mode,DistId,ModeAccess,DistMask
    Allowed values: Mode, DistId, ModeAccess, DistMask, Banner, Language, MasterAuthority, Printer, UserId

#### OM Web Viewer Connection Options

- `--host` | `--hostname` (string)

  - Hostname or ip address of the target OM Web Viewer instance.

- `--port` (number)

  - Port of the target OM Web Viewer instance.

    Default value: 443

- `--user` | `--username` (string)

  - User name used to authenticate against the target OM Web Viewer instance.

- `--password` (string)

  - Password used to authenticate against the target OM Web Viewer instance.

- `--base-path` (string)

  - Context name of the target OM Web Viewer instance.

    Default value: web-viewer

- `--protocol` (string)

  - Protocol of the target OM Web Viewer instance.

    Default value: https
    Allowed values: http, https

#### Profile Options

- `--omview-profile` | `--omview-p` (string)

  - The name of a (omview) profile to load for this command execution.

- `--caview-profile` | `--caview-p` (string)

  - The name of a (caview) 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

- `--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

## zowe › ops

Interact with OPS/MVS® for automation administration and resource management.

## zowe › ops › create

Create a generic AOF event for API rules processing.

### zowe › ops › create › event

Create a generic AOF event for API rules processing

#### Usage

zowe ops create event <eventCode> <eventText> [options]

#### Positional Arguments

- `eventCode` (string)

  - The event code that is passed, upper-cased, to API rules in the AOF variable API.ID. This code can be up to 10 characters long.

- `eventText` (string)

  - The event text that is passed, unaltered, to API rules in the AOF variable API.TEXT. This text can be up to 255 characters long.

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Create a generic AOF event, "EVENTCODE" for API rules processing on the "OPSS" subsystem.:

  - `zowe ops create event "EVENTCODE" "eventtext" --subsystem "OPSS"`

## zowe › ops › disable

Disable an Automated Operations Facility rule.

### zowe › ops › disable › rule

Disable the specified rule.

#### Usage

zowe ops disable rule <ruleset> <rule> [options]

#### Positional Arguments

- `ruleset` (string)

  - The ruleset containing the rule.

- `rule` (string)

  - The name of the rule.

#### Options

- `--format` | `-f` (string)

  - Format of the displayed output.

    Default value: namevalue
    Allowed values: namevalue, namevaluecolor, csv, json

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Disable the rule "MYRULE" in the ruleset "OPSRULES" for the "OPSS" subsystem.:

  - `zowe ops disable rule "OPSRULES" "MYRULE" --subsystem "OPSS"`

## zowe › ops › enable

Enable an Automated Operations Facility rule.

### zowe › ops › enable › rule

Enable the specified rule.

#### Usage

zowe ops enable rule <ruleset> <rule> [options]

#### Positional Arguments

- `ruleset` (string)

  - The ruleset containing the rule.

- `rule` (string)

  - The name of the rule.

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Enable the rule "MYRULE" in the ruleset "OPSRULES" for the "OPSS" subsystem.:

  - `zowe ops enable rule "OPSRULES" "MYRULE" --subsystem "OPSS"`

## zowe › ops › execute

Execute an OPS/MVS REXX program or an operator command.

### zowe › ops › execute › command

Execute the specified operator command.

#### Usage

zowe ops execute command <command> [options]

#### Positional Arguments

- `command` (string)

  - The text of the operator command to be issued. The length of this string cannot exceed 240 characters.

#### Options

- `--bmpCmdOut` | `--bco` (string)

  - If the specified command is an IMS command, this parameter controls the echoing of the command output. This keyword only applies if you are using an IMS Operations Facility (IOF) Batch Message Processing (BMP) program for issuing IMS commands. Valid values are: OPSLOG, WTO, and NONE. A value of 'OPSLOG' echoes all output that is associated with the current IMS command back to OPSLOG as trace messages. This results in a small amount of additional overhead to the command, assuming that the number of lines of output is not large. No output is sent back to any z/OS console or to the subsystem interface. A value of 'WTO' echoes all output that is associated with the current IMS command as Write To Operator messages to the z/OS console. Using this option can add a significant amount of overhead to IMS command processing and has the potential of flooding the consoles with command output messages. A value of 'NONE' sends IMS commands to the BMP and returns the responses to the issuing program (if so requested). This recommended approach results in the lowest amount of overhead. The use of this parameter does not affect how the IMS command output is returned to the command issuer. The default value for this parameter is 'NONE'.

- `--capture` | `--cp` (string)

  - This parameter captures command responses that are not internally routed back to the OPS/MVS console that issued the command. If this parameter is specified, command response messages are captured based on text segments matching the first characters (starting with column 1) of the messages. These captured response messages are in addition to the usual command response messages that are captured based on other specified parameters. You can specify up to 10 message text segments with this parameter, and each text segment can have up to 124 characters.

- `--cart` | `--ct` (string)

  - This parameter specifies a z/OS command and response token (CART). This token can be represented as either a one- to eight-character string such as MYCMDTOK, or as a one- to eight-byte hexadecimal value such as X'D6D7E2E205162738'. Messages issued in response to this command are issued using the same CART. If this parameter is not specified, OPS/MVS will generate a unique CART token and use this generated token to determine which response messages should be returned to the caller.

- `--cmdEcho` | `--ce` (string)

  - This parameter determines whether the issued command is echoed as the first line of the command response. You can specify either YES, which is the default, or NO. This parameter is ignored when the cmdLog parameter is set to NO.

- `--cmdLog` | `--cl` (string)

  - This parameter determines whether the issued command is echoed in both SYSLOG and the command response, or neither. You can specify either YES, which is the default, or NO. The NO setting overrides the setting of the cmdEcho parameter.

- `--cmdWait` | `--cw` (string)

  - This parameter specifies, in seconds, how long to wait for command output collection to complete. The number of lines that are collected are analyzed every few hundredths of a second, based on the value specified with the interval parameter. If no new output lines are forthcoming after at least two output lines have been received, the wait for more response characters is terminated before this cmdWait period expires. You can specify a value for this parameter from 1 through 600 seconds. If you specify a value of YES for the stopEnd parameter, the end line of a multi-line WTO message also stops response collection. The main difference between the cmdWait and wait parameters is that the wait parameter specifies an unconditional wait period, while the cmdWait parameter specifies a conditional wait based on a continuous, timely collection of response lines. The default value for this parameter is the value of the OCWAIT global OPS/MVS parameter. When used in IMS Type 2 message syntax, the cmdWait and wait parameters are identical and specify the maximum wait time in seconds for message completion. IBM documentation on IMSPLEX usage implies that the delay in gathering results from multiple IMS systems can be considerable and should be considered normal. The default if omitted is 120, or 2 minutes. This cmdWait parameter is mutually exclusive with the wait parameter.

- `--conName` | `--cn` (string)

  - This parameter defines the name of the console to receive the issued command. The console name that you provide can contain as many as eight characters. You can retrieve command output when the specified console is allocated to OPS/MVS. If the console is not allocated or does not exist, this request will return an error code of 190. This conName parameter is mutually exclusive with the conType parameter.

- `--conType` | `--cnt` (string)

  - This parameter specifies the appropriate type of console that should be used for the command that you are issuing. The default value for this parameter is the current value of the OCCONTYPE global OPS/MVS parameter. Valid values are: ANY, EXTCONS, SSCONS, or XTRACONS. A value of 'ANY' tells OPS/MVS to select the first available console to issue the command. In this case, OPS/MVS selects consoles in the following order: Subsystem consoles, followed by XTRACONS consoles, and finally Extended consoles. A value of 'EXTCONS' tells OPS/MVS to select the first available extended console. Extended consoles are controlled by the EXTENDEDCONSOLES global OPS/MVS parameter. A value of 'SSCONS' tells OPS/MVS to select the first available subsystem console. Subsystem consoles are controlled by the SUBSYSDEFAULT global OPS/MVS parameter. A value of 'XTRACONS' tells OPS/MVS to select the first available extra extended console. Extra extended consoles are controlled by the EXTRAEXTCONSOLES global OPS/MVS parameter. This conType parameter is mutually exclusive with the conName parameter.

- `--imsId` | `--id` (string)

  - If you use the IMS Operations Facility (IOF) at your site, you can use the /opscmd endpoint to issue IMS commands. If you are running only one copy of IMS on the system where the current instance of the OPS/MVS REST API is running, you can omit the imsId parameter. However, if several copies of IMS (such as a production version and a test version) reside on the system, use this parameter to specify the IMS control region that should receive the command. IMS IDs can contain from one to four characters. IBM ships IMS with a default IMS ID of IMSA. If you do not know the IMS ID of the IMS you want OPS/MVS to control, ask your systems management department. When used in IMS Type 2 message syntax, the command is issued to the IMSPLEX manager, and distributed from there. The imsId parameter is used to establish the eligibility of participating IMS systems to receive the command. If the imsId parameter is omitted, the first IMS system capable of responding receives the command. If the value of the imsId parameter is specified as a wildcard *, all participating IMS systems receive the command. The value of the imsId parameter can also be specified as a list, separated by spaces or commas, of specific IMS system names to receive the command. The wildcard * should not be used with the imsId parameter unless the imsPlex parameter is specified with an explicit name.

- `--imsPlex` | `--ip` (string)

  - If you use the IMS Operations Facility (IOF) at your site, you can use the /opscmd endpoint to issue IMS commands. If you are running only one copy of IMS on the system where the current instance of the OPS/MVS REST API is running, you can omit the imsId parameter. However, if several copies of IMS (such as a production version and a test version) reside on the system, use this parameter to specify the IMS control region that should receive the command. IMS IDs can contain from one to four characters. IBM ships IMS with a default IMS ID of IMSA. If you do not know the IMS ID of the IMS you want OPS/MVS to control, ask your systems management department. When used in IMS Type 2 message syntax, the command is issued to the IMSPLEX manager, and distributed from there. The imsId parameter is used to establish the eligibility of participating IMS systems to receive the command. If the imsId parameter is omitted, the first IMS system capable of responding receives the command. If the value of the imsId parameter is specified as a wildcard *, all participating IMS systems receive the command. The value of the imsId parameter can also be specified as a list, separated by spaces or commas, of specific IMS system names to receive the command. The wildcard * should not be used with the imsId parameter unless the imsPlex parameter is specified with an explicit name.

- `--imsReply` | `--ir` (string)

  - The presence of this imsPlex parameter implies you are issuing an IMS command using the IMS Type 2 message syntax. This value can be specified as a specific IMSPLEX name, in which case the imsId parameter controls the selection of participating IMS systems. The imsPlex parameter can also be specified as a wildcard *, meaning the imsId determines the IMSPLEX name. In this case, the imsId parameter cannot be specified as a wildcard *, but must contain a valid IMS system name. The imsId parameter, or the first of a list, will be used to locate the name of its associated IMSPLEX.

- `--interval` | `--int` (string)

  - This parameter specifies, in centiseconds, how frequently to test for command response lines to see if the response has ended. This interval parameter temporarily overrides the value of the OCINTERVAL global OPS/MVS parameter. The default for this interval parameter is the value of the OCINTERVAL global OPS/MVS parameter, but you can specify any number from 10 through 300, or a value of 0 to bypass interval testing.

- `--localOnly` | `--loc` (string)

  - When 'YES' is specified for this parameter, only messages from the local system are considered as potential command response candidates. This parameter should be used in conjunction with the capture and stopMsg parameters to prevent output from other systems possibly being returned as command output. You can specify either NO, which is the default, or YES.

- `--log` | `--lg` (string)

  - This parameter determines whether response lines from the issued command go into the SYSLOG and/or OPSLOG data sets. Valid options are: YES, NO, OFF, and NOWHERE. A value of 'YES' means command responses and command echo will be logged in both SYSLOG and OPSLOG. A value of 'NO' means SYSLOG will only contain the command echo, not the command responses, and OPSLOG will contain both the command echo and the command responses. A value of 'OFF' means the command echo and command responses will not be logged to SYSLOG. OPSLOG will contain the command responses, but not the command echo. A value of 'NOWHERE' means the command echo and command responses will not be logged to either the SYSLOG or the OPSLOG. Note that the logging of command response lines is also influenced by MIC and AOF rule processing. The default value for this parameter is 'YES'.

- `--maxCmdOut` | `--mco` (string)

  - This parameter defines how many command output lines to collect before terminating the command response. If the command output contains more lines than this maxCmdOut value, no more command output lines are collected. You can specify any value from 1 through 32767 for this parameter. The default value for this parameter is the value of the OCMAXMSG global OPS/MVS parameter.

- `--output` | `--out` (string)

  - This parameter determines whether you receive output from the issued command. You can specify either YES, which is the default, or NO. The NO setting is mutually exclusive with the wait parameter.

- `--stopEnd` | `--se` (string)

  - This parameter determines whether the end line of a multiline WTO message stops the collection of command output. Valid options are: YES, and NO. A value of 'YES' will cause the command response to terminate at the first end line of a multiline WTO message or at the time that is specified through the cmdWait parameter or the OCWAIT global OPS/MVS parameter. A value of 'NO' will cause the command output to continue collecting until either: the time interval that is specified by the cmdWait parameter or the OCWAIT global parameter expires; or no new command output lines are collected in the time interval that is specified by the interval parameter. The default value for this parameter is 'YES'.

- `--stopMsg` | `--sm` (string)

  - This parameter specifies a list of one to ten message text segments matching the first characters (starting with column 1) of the messages that terminate the collection of command response lines. When any of these text segments are detected, the collection of response lines stops. The message segment or segments you specify need not be directed to the console receiving the command response. Each item in the list of message text segments you specify can contain no more than 124 characters. All message text segments that are specified on this parameter will match both uppercase and lowercase text in potential matching messages (case-insensitive). This parameter does not work with IMS Type 2 commands. The stopMsg and stopResp parameters are mutually exclusive.

- `--stopResp` | `--sr` (string)

  - This parameter specifies a list of one to ten message text segments matching the first characters (starting with column 1) of the messages that terminate the collection of command response lines. The message segments that you specify must be directed to the console receiving the command response, and each item in the segment list can contain no more than 124 characters. You can use this stopResp parameter to terminate the collection of a long command response once the desired response line is found. All message text segments that are specified on this keyword will match both uppercase and lowercase text in potential matching messages (case-insensitive). The stopResp and stopMsg parameters are mutually exclusive.

- `--wait` | `-w` (number)

  - This parameter specifies a period of time (in seconds) to unconditionally wait to receive output from the issued command. Control is not returned to the caller until the full wait period elapses. In most cases, a conditional wait using the cmdWait parameter in conjunction with the interval and various stopXxxx parameters can be used to effectively collect command responses, thus eliminating the need for an unconditional wait. When used in IMS Type 2 message syntax, the wait parameter is identical to the cmdWait parameter. This wait parameter is mutually exclusive with the cmdWait parameter. If the output parameter is set to NO, you can not use this parameter (mutually exclusive).

- `--format` | `-f` (string)

  - Format of the displayed output.

    Default value: namevalue
    Allowed values: namevalue, namevaluecolor, csv, json

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Execute the operator command, "D A,L" on the "OPSS" subsystem.:

  - `zowe ops execute command "D A,L" --subsystem "OPSS"`

### zowe › ops › execute › rexx

Execute the specified OPS/MVS REXX program.

#### Usage

zowe ops execute rexx <program> [options]

#### Positional Arguments

- `program` (string)

  - The name of the OPS/REXX source program. When enclosed in single quotes, the program name can be either a fully qualified data set name (sequential or PDS including member) or a member of a precompiled REXX data set. When not enclosed in quotes, the program name is expanded as follows: If it is in the format MYLIB, it is expanded to {USER_PREFIX}.MYLIB.REXX, where {USER_PREFIX} represents your default TSO prefix. If it is in the format MYLIB(MEMBER), it is expanded to {USER_PREFIX}.MYLIB.REXX(MEMBER). If it is in the format (MEMBER), it is expanded to {USER_PREFIX}.REXX(MEMBER).

#### Options

- `--argument` | `--arg` (string)

  - Specifies any characters to be passed to the OPS/REXX program. Leading blanks are stripped from the argument. Any embedded quotes will be passed on to the called OPS/REXX program unaltered and unfiltered. The length of the string cannot exceed 256 characters.

- `--maxQueue` | `--mq` (string)

  - The maximum number of output lines that this OPS/REXX program can have in its external data queue.

- `--workspace` | `--ws` (string)

  - Defines the size of the OPS/REXX program workspace, in bytes. The workspace size limits the maximum number of nested calls, symbols, and values that can be used during program execution. If your program has a large memory requirement, use this size value to specify a workspace that is larger than the default of 1.5 MB.

- `--timeout` | `--to` (string)

  - The amount of elapsed time (in minutes) the OPS/REXX program is allowed to execute. If this parameter is not specified, the default value specified in the application.yml (configuration file for the REST API server) parameter 'opsmvs.rexxExecRunTimeout' will be used. If the value specified for this parameter is zero, then no timeout limit is imposed on the OPS/REXX program.

- `--outputLimit` | `--ol` (string)

  - The maximum number of output lines the OPS/REXX program is allowed to generate before the OPS/REXX program is canceled. If this parameter is not specified, the default value specified in the application.yml (configuration file for the REST API server) parameter 'opsmvs.rexxExecOutputLimit' will be used. If the value for this parameter is zero, then no output limit is imposed on the OPS/REXX program.

- `--wait` | `-w` (number)

  - Wait for the specified number of seconds for the OPS/MVS REXX program to end and the output to be returned. By default the command returns immediately after initiating the program's execution.

    Default value: 10

- `--format` | `-f` (string)

  - Format of the displayed output.

    Default value: namevalue
    Allowed values: namevalue, namevaluecolor, csv, json

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Execute the REXX program "PROGRAM" in the dataset "OPS.REXX" on the "OPSS" subsystem.:

  - `zowe ops execute rexx "OPS.REXX(PROGRAM)" --subsystem "OPSS"`

- Execute the REXX program "PROGRAM" in the dataset "{USER_PREFIX}.REXX" on the "OPSS" subsystem.:

  - `zowe ops execute rexx "(PROGRAM)" --subsystem "OPSS"`

## zowe › ops › show

Display data associated with OPS/MVS automation elements, such as AOF rules and rulesets, and SSM resources, OPS log names, subsystems and RDF tables, or REST API server status.

### zowe › ops › show › logname

Display a list of the OPSLOG lognames that are defined to the specified subsystem. The list also identifies the live OPSLOG. This command is only available when connected to the OPS/MVS REST API server.

#### Usage

zowe ops show logname [options]

#### Options

- `--format` | `-f` (string)

  - Format of the displayed output.

    Default value: namevalue
    Allowed values: namevalue, namevaluecolor, csv, json

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Show the data for the logs defined for the "OPSS" subsystem:

  - `zowe ops show logname --subsystem "OPSS"`

### zowe › ops › show › resource

Display data associated with the specified SSM resource. Currently, only the current and desired states of the resource are displayed.

#### Usage

zowe ops show resource <resourcename> [options]

#### Positional Arguments

- `resourcename` (string)

  - The name of the resource.

#### Options

- `--tablename` | `--table` (string)

  - The name of the table that contains the resource. If not specified, the command searches all SSM tables and displays each instance of the resource that is found.

- `--format` | `-f` (string)

  - Format of the displayed output.

    Default value: namevalue
    Allowed values: namevalue, namevaluecolor, csv, json

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Show the current and desired state of the resource "RESOURCE1" in the table "MYTABLE" for the "OPSS" subsystem:

  - `zowe ops show resource "RESOURCE1" --table "MYTABLE" --subsystem "OPSS"`

- Show the current and desired state of all resources in the table "MYTABLE" for the "OPSS" subsystem. This command is only available when connected to the OPS/MVS REST API server:

  - `zowe ops show resource * --table "MYTABLE" --subsystem "OPSS"`

- Show the current and desired state of all resources in all tables for the "OPSS" subsystem. This command is only available when connected to the OPS/MVS REST API server:

  - `zowe ops show resource * --subsystem "OPSS"`

### zowe › ops › show › rule

Display data associated with the specified rule.

#### Usage

zowe ops show rule <ruleset> <rule> [options]

#### Positional Arguments

- `ruleset` (string)

  - The ruleset containing the rule.

- `rule` (string)

  - The name of the rule.

#### Options

- `--format` | `-f` (string)

  - Format of the displayed output.

    Default value: namevalue
    Allowed values: namevalue, namevaluecolor, csv, json

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Show the data in csv format of the rule "MYRULE" in the ruleset "OPSRULES" for the "OPSS" subsystem:

  - `zowe ops show rule "OPSRULES" "MYRULE" --subsystem "OPSS" -f csv`

- Show the data of all rules in ruleset "OPSRULES" for the "OPSS" subsystem. This command is only available when connected to the OPS/MVS REST API server:

  - `zowe ops show rule "OPSRULES" "*" --subsystem "OPSS"`

- Show the data of all rules in all rulesets for the "OPSS" subsystem. This command is only available when connected to the OPS/MVS REST API server:

  - `zowe ops show rule "*" "*" --subsystem "OPSS"`

### zowe › ops › show › ruleset

Display data associated with one or all rulesets for a specified subsystem. This command is only available when connected to the OPS/MVS REST API server.

#### Usage

zowe ops show ruleset [options]

#### Options

- `--ruleset` (string)

  - The ruleset to display.

- `--format` | `-f` (string)

  - Format of the displayed output.

    Default value: namevalue
    Allowed values: namevalue, namevaluecolor, csv, json

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Show the data for the rulesets defined for the "OPSS" subsystem:

  - `zowe ops show ruleset --subsystem "OPSS"`

- Show the data for ruleset "CICS" for the default OPS/MVS subsystem:

  - `zowe ops show ruleset --ruleset "CICS"`

- Show the data for ruleset IMS for the "OPSS" subsystem:

  - `zowe ops show ruleset --ruleset "IMS" --subsystem "OPSS"`

### zowe › ops › show › status

Display data associated with an OPS/MVS REST API server. This command is only available when connected to the OPS/MVS REST API server.

#### Usage

zowe ops show status [options]

#### Options

- `--format` | `-f` (string)

  - Format of the displayed output.

    Default value: namevalue
    Allowed values: namevalue, namevaluecolor, csv, json

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Show the data for REST API in "CSV" format:

  - `zowe ops show status --format "csv"`

### zowe › ops › show › subsystem

Display a list of the OPS/MVS subsystems that are running on the host z/OS LPAR. This command is only available when connected to the OPS/MVS REST API server.

#### Usage

zowe ops show subsystem [options]

#### Options

- `--format` | `-f` (string)

  - Format of the displayed output.

    Default value: namevalue
    Allowed values: namevalue, namevaluecolor, csv, json

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Show the data for the OPS/MVS subsystems that are running on the host system:

  - `zowe ops show subsystem`

### zowe › ops › show › table

Display a list of the RDF tables that are defined to the specified subsystem. This command is only available when connected to the OPS/MVS REST API server.

#### Usage

zowe ops show table [options]

#### Options

- `--tablename` | `--table` (string)

  - The optional filter used to describe which table names will be returned. You can specify either an absolute table name or a table name containing one or more wildcard characters (* or ?). The * wildcard will match zero or more characters, and the ? wildcard will match any single character. If no value is specified, the value * will be used.

- `--format` | `-f` (string)

  - Format of the displayed output.

    Default value: namevalue
    Allowed values: namevalue, namevaluecolor, csv, json

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Show the tables defined for the "OPSS" subsystem:

  - `zowe ops show table --subsystem "OPSS"`

- Show the tables starting with 'SSM' defined for the "OPSS" subsystem:

  - `zowe ops show table --subsystem "OPSS" --table "SSM*"`

## zowe › ops › start

Start a System State Manager resource.

### zowe › ops › start › resource

Start the specified resource. The desired state of the resource is set to the appropriate UP state and SSM takes action to start the resource.

#### Usage

zowe ops start resource <resourcename> <tablename> [options]

#### Positional Arguments

- `resourcename` (string)

  - The name of the resource.

- `tablename` (string)

  - The name of the table that contains the resource.

#### Options

- `--wait` | `-w` (number)

  - Wait for the specified number of seconds for the current state of the SSM resource to match the new desired state. If more than the specified number of seconds elapses and the current and desired states still do not match, the command fails with a timeout error.

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Start the resource RESOURCE1 in the table "MYTABLE" for subsystem "OPSS".:

  - `zowe ops start resource "RESOURCE1" "MYTABLE" --subsystem "OPSS"`

- Start the resource "RESOURCE1" in the table "MYTABLE" for the "OPSS" subsystem, and wait for up to 2 minutes for "RESOURCE1" to have a current state of UP.:

  - `zowe ops start resource "RESOURCE1" "MYTABLE" --subsystem "OPSS" -w 120`

## zowe › ops › stop

Stop a System State Manager resource.

### zowe › ops › stop › resource

Stop the specified resource. The desired state of the resource is set to the appropriate DOWN state and SSM takes action to stop the resource.

#### Usage

zowe ops stop resource <resourcename> <tablename> [options]

#### Positional Arguments

- `resourcename` (string)

  - The name of the resource.

- `tablename` (string)

  - The name of the table that contains the resource.

#### Options

- `--wait` | `-w` (number)

  - Wait for the specified number of seconds for the current state of the SSM resource to match the new desired state. If more than the specified number of seconds elapses and the current and desired states still do not match, the command fails with a timeout error.

#### OPS/MVS Web Services / REST API connection options

- `--user` (string)

  - Your z/OS user name that is used to authenticate to OPS/MVS Web Services / REST API.

- `--password` | `--pass` (string)

  - Your z/OS password that is used to authenticate to OPS/MVS Web Services / REST API.

- `--host` (string)

  - The hostname of the server where OPS/MVS Web Services / REST API is running.

- `--port` | `-p` (number)

  - The port number for OPS/MVS Web Services / REST API.

- `--reject-unauthorized` | `--ru` (boolean)

  - If set to true, the server certificate is verified against the list of supplied CAs. If set to false, certificate verification is not performed.

    Default value: true

- `--protocol` | `--prot` (string)

  - The protocol that is used for connecting to OPS/MVS Web Services / REST API.

    Default value: https
    Allowed values: http, https

- `--subsystem` | `--subs` (string)

  - Specifies the subsystem ID of the OPS/MVS instance to which commands will be directed. This parameter is ignored with the 'show status' and 'show subsystem' commands.

    Default value: OPSS

- `--rest-api` | `--ra` (boolean)

  - If set to true, the plug-in executes the command against the OPS/MVS REST API. If set to false, the plug-in executes against the OPS/MVS Web Services.

    Default value: false

- `--base-path` | `--bp` (string)

  - NOTE: This can only be used with the REST API server. The base path for your Zowe API Mediation Layer instance. Specify this option to prepend the base path to all resources when making REST requests. Only specify this option if you are using an Zowe API Mediation Layer.

#### Profile Options

- `--ops-profile` | `--ops-p` (string)

  - The name of a (ops) 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

- `--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

- Stop the resource "RESOURCE1" in the table "MYTABLE" for the "OPSS" subsystem.:

  - `zowe ops stop resource "RESOURCE1" "MYTABLE" --subsystem "OPSS"`

- Stop the "RESOURCE1" in the table "MYTABLE" for the "OPSS" subsystem, and wait for up to 2 minutes for "RESOURCE1" to have a current state of DOWN.:

  - `zowe ops stop resource "RESOURCE1" "MYTABLE" --subsystem "OPSS" -w 120`

## zowe › plugins

Install and manage plug-ins.

### zowe › plugins › install

Install plug-ins to an application.

#### Usage

zowe plugins install [plugin...] [options]

#### Positional Arguments

- `plugin...` (string)

  - A space-separated list of plug-ins to install. A plug-in can be any format that is accepted by the `npm install` command (local directory, TAR file, git URL, public package, private package, etc...).

    To use a relative local directory, at least one '/' or '\' must exist in the plug-in path. For example, you have a local plug-in in a folder called 'test-plugin' that you want to install. Specify the relative local directory by issuing the following command:

    zowe plugins install ./test-plugin

    If you omit the './', then the install command looks for 'test-plugin' in an npm registry.

    If the plugin argument is omitted, the plugins.json file will determine which plug-ins are installed. For more information on the plugins.json file, see the --file option.

#### Options

- `--file` (local file path)

  - Specifies the location of a plugins.json file that contains the plug-ins you want to install.

    All plug-ins specified in plugins.json will be installed to the base CLI and the contents will be placed into /home/<user>/.zowe/plugins/plugins.json.

    If you do not specify a plugins.json file and do not specify a plug-in, the default plugin.json file (/home/<user>/.zowe/plugins/plugins.json) will be used. This provides a way to install plug-ins that were lost or corrupted after reinstalling or updating Zowe CLI.

- `--registry` (string)

  - The npm registry that is used when installing remote packages. When this value is omitted, the value returned by `npm config get registry` is used.

    For more information about npm registries, see: https://docs.npmjs.com/misc/registry

- `--login` (boolean)

  - The flag to add a registry user account to install from secure registry. It saves credentials to the .npmrc file using `npm login`. When this value is omitted, credentials from .npmrc file is used. If you used this flag once for specific registry, you don't have to use it again, it uses credentials from .npmrc file.

    For more information about npm registries, see:
    https://docs.npmjs.com/cli/login for NPM >= 9
    https://docs.npmjs.com/cli/adduser for NPM < 9

- `--verbose` (boolean)

  - Specifies that verbose output is printed for npm install.
    This may be useful for debugging errors during plugin installation.

#### Examples

- Install plug-ins saved in /home/<user>/.zowe/plugins/plugins.json:

  - `zowe plugins install`

- Install plug-ins saved in a properly formatted config file:

  - `zowe plugins install --file /some/file/path/file_name.json`

- Install a remote plug-in:

  - `zowe plugins install my-plugin`

- Install a remote plug-in using semver:

  - `zowe plugins install my-plugin@"^1.2.3"`

- Install a remote plug-in from the specified registry:

  - `zowe plugins install my-plugin --registry https://registry.npmjs.org/`

- Install a local folder, local TAR file, and a git URL:

  - `zowe plugins install ./local-file /root/tar/some-tar.tgz git://github.com/project/repository.git#v1.0.0`

- Install a remote plug-in from the registry which requires authorization(don't need to use this flag if you have already logged in before):

  - `zowe plugins install my-plugin --registry https://registry.npmjs.org/ --login`

### zowe › plugins › list

List all plug-ins installed.

#### Usage

zowe plugins list [options]

#### Options

- `--short` | `-s` (boolean)

  - Show output in abbreviated format

### zowe › plugins › show-first-steps

Show first steps required to set up plug-in for use.

#### Usage

zowe plugins show-first-steps [plugin] [options]

#### Positional Arguments

- `plugin` (string)

  - The name of the installed plug-in to show first steps for.

    If the plug-in argument is omitted, no action is taken.

#### Examples

- Show first steps for a plug-in called 'my-plugin':

  - `zowe plugins show-first-steps my-plugin`

### zowe › plugins › uninstall

Uninstall plug-ins.

#### Usage

zowe plugins uninstall [plugin...] [options]

#### Positional Arguments

- `plugin...` (string)

  - The name of the plug-in to uninstall.

    If the plug-in argument is omitted, no action is taken.

#### Examples

- Uninstall a plug-in:

  - `zowe plugins uninstall my-plugin`

### zowe › plugins › update

Update plug-ins.

#### Usage

zowe plugins update [plugin...] [options]

#### Positional Arguments

- `plugin...` (string)

  - The name of the plug-in to update.

    If the plug-in argument is omitted, no action is taken.

#### Options

- `--registry` (string)

  - The npm registry that is used when installing remote packages. When this value is omitted, the value returned by `npm config get registry` is used.

    For more information about npm registries, see: https://docs.npmjs.com/misc/registry

- `--login` (boolean)

  - The flag to add a registry user account to install from secure registry. It saves credentials to the .npmrc file using `npm login`. When this value is omitted, credentials from .npmrc file is used. If you used this flag once for specific registry, you don't have to use it again, it uses credentials from .npmrc file.

    For more information about npm registries, see:
    https://docs.npmjs.com/cli/login for NPM >= 9
    https://docs.npmjs.com/cli/adduser for NPM < 9

#### Examples

- Update a plug-in:

  - `zowe plugins update my-plugin`

- Update a remote plug-in from the registry which requires authorization(don't need to use this flag if you have already logged in before):

  - `zowe plugins update my-plugin --registry https://registry.npmjs.org/ --login`

### zowe › plugins › validate

Validate a plug-in that has been installed.

#### Usage

zowe plugins validate [plugin] [options]

#### Positional Arguments

- `plugin` (string)

  - The name of the plug-in to validate.
    Validation issues identified for this plug-in are displayed.

    If the plug-in argument is omitted, all installed plug-ins are validated.

#### Options

- `--fail-on-error` | `--foe` (boolean)

  - Enables throwing an error and setting an error code if plugin validation detects an error.

    Default value: true

- `--fail-on-warning` | `--fow` (boolean)

  - Treat validation warnings as errors. Requires fail-on-error.

    Default value: false

#### Examples

- Validate a plug-in named my-plugin:

  - `zowe plugins validate my-plugin`

- Validate all installed plug-ins:

  - `zowe plugins validate`

- Validate a plug-in named my-plugin, and treat warnings as errors:

  - `zowe plugins validate my-plugin --fail-on-warning`

## zowe › provisioning

Perform z/OSMF provisioning tasks on Published Templates in the Service Catalog and Provisioned Instances in the Service Registry.

## zowe › provisioning › delete

Deletes instance previously provisioned with z/OSMF cloud provisioning services.

### zowe › provisioning › delete › instance

Deletes selected deprovisioned instance.

#### Usage

zowe provisioning delete instance <name> [options]

#### Positional Arguments

- `name` (string)

  - Deprovisioned Instance name.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Delete deprovisioned instance "instance1":

  - `zowe provisioning delete instance instance1`

## zowe › provisioning › list

Lists z/OSMF provisioning information such as the provisioned instances from the registry, the provisioned instance details, the available provisioning templates and provisioning template details.

### zowe › provisioning › list › catalog-templates

Lists the z/OSMF service catalog published templates.

#### Usage

zowe provisioning list catalog-templates [options]

#### Options

- `--all-info` | `--ai` (boolean)

  - Display information about published z/OSMF service catalog templates (summary information is printed by default).

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- List all published templates in the z/OSMF service catalog (with full detail):

  - `zowe provisioning list catalog-templates --all-info`

### zowe › provisioning › list › instance-info

List details about an instance provisioned with z/OSMF.

#### Usage

zowe provisioning list instance-info <name> [options]

#### Positional Arguments

- `name` (string)

  - Provisioned Instance Name

#### Options

- `--display` (string)

  - Level of information to display for the provisioned instance. Possible values:

    summary - summary information, no actions or variables
    actions - (default) summary with actions, no variables
    vars - summary information with variables, no actions
    extended - extended information with actions
    full - all available information

    Allowed values: extended, summary, vars, actions, full

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- List summary information with a list of actions for an instance with the name "instance1":

  - `zowe provisioning list instance-info instance1`

- Show extended general information with actions for a provisioned instance with the name "instance1":

  - `zowe provisioning list instance-info instance1 --display extended`

### zowe › provisioning › list › instance-variables

List a set of variables and their values for a given name.

#### Usage

zowe provisioning list instance-variables <name> [options]

#### Positional Arguments

- `name` (string)

  - Provisioned Instance Name

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List instance variables of "instance1":

  - `zowe provisioning list instance-variables instance1`

### zowe › provisioning › list › registry-instances

List the provisioned instances from the z/OSMF software registry.

#### Usage

zowe provisioning list registry-instances [options]

#### Options

- `--all-info` | `--ai` (boolean)

  - Display all available information about provisioned instances (summary by default).

- `--filter-by-type` | `--fbt` (string)

  - Filter the list of provisioned instances by type (e.g. DB2 or CICS).

- `--filter-by-external-name` | `--fben` (string)

  - Filter the list of provisioned instances by External Name.

- `--types` | `-t` (boolean)

  - Display a list of all types for provisioned instances (e.g. DB2 or CICS).

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- List all provisioned instances (with full detail):

  - `zowe provisioning list registry-instances --all-info`

### zowe › provisioning › list › template-info

List details about a template published with z/OSMF Cloud Provisioning.

#### Usage

zowe provisioning list template-info <name> [options]

#### Positional Arguments

- `name` (string)

  - The name of a z/OSMF cloud provisioning template.

#### Options

- `--all-info` | `--ai` (boolean)

  - Display detailed information about published z/OSMF service catalog template (summary information is printed by default).

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- List summary information for template "template1":

  - `zowe provisioning list template-info template1`

## zowe › provisioning › perform

Perform actions against instances provisioned with z/OSMF.

### zowe › provisioning › perform › action

Perform actions on instances previously provisioned with z/OSMF cloud
provisioning services. To view the list of provisioned instances, use the
"zowe provisioning list registry-instances" command. Once you have
obtained an instance name you can use the "zowe provisioning list
instance-info <name>" command to view the available instance actions.

#### Usage

zowe provisioning perform action <name> <actionname> [options]

#### Positional Arguments

- `name` (string)

  - Provisioned Instance name.

- `actionname` (string)

  - The action name. Use the "zowe provisioning list instance-info <name>"
    command to view available instance actions.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Perform the "start" action on the provisioned instance "instance1":

  - `zowe provisioning perform action instance1 start`

## zowe › provisioning › provision

Using z/OSMF cloud provisioning services provision available templates.

### zowe › provisioning › provision › template

Using z/OSMF cloud provisioning services, provision available templates.
You can view available templates using the zowe provisioning list catalog-templates command.

#### Usage

zowe provisioning provision template <name> [options]

#### Positional Arguments

- `name` (string)

  - The name of a z/OSMF cloud provisioning template.

#### Options

- `--properties` | `-p` (string)

  - A sequence of string enclosed "name=value" pairs of prompt variables.
    e.g: "CSQ_MQ_SSID=ZCT1,CSQ_CMD_PFX=!ZCT1".

- `--properties-file` | `--pf` (string)

  - Path to .yml file containing properties.

- `--domain-name` | `--dn` (string)

  - Required if the user has consumer authorization to more than one domain with this template name.

- `--tenant-name` | `--tn` (string)

  - Required if the user has consumer authorization to more than one tenant in the same domain that contains this template name.

- `--user-data-id` | `--udi` (string)

  - ID for the user data specified with user-data. Passed into the software services registry.

- `--user-data` | `--ud` (string)

  - User data that is passed into the software services registry. Can be specified only if user-data-id is provided.

- `--account-info` | `--ai` (string)

  - Account information to use in the JCL JOB statement. The default is the account information that is associated with the resource pool for the tenant.

- `--system-nick-names` | `--snn` (string)

  - Each string is the nickname of the system upon which to provision the software service defined by the template. The field is required if the resource pool associated with the tenant used for this operation is not set up to automatically select a system. Only one nickname is allowed.If the field is provided it is validated.
    e.g: "SYSNAME1,SYSNAME2".

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Provision a published software service template.:

  - `zowe provisioning provision template template1`

## zowe › sysview

Zowe CLI plugin for SYSVIEW

### zowe › sysview › capture

Display output from a primary command stored in a SYSVIEW capture data set

#### Usage

zowe sysview capture <capture-dsn> <capture-command> [options]

#### Positional Arguments

- `capture-dsn` (string)

  - Capture data set name from which to retrieve captured commands

- `capture-command` (string)

  - Captured command to retrieve

#### data options

- `--capture-row` | `--cr` (number)

  - Row number of command within capture data set

- `--capture-screen` | `--cs` (string)

  - Screen name, for commands which have multiple screens

- `--capture-title` | `--ct` (string)

  - The captured command screen title or a user supplied title specified on the CAPIMMED command

- `--fields` | `-f` (array)

  - Fields to be returned (by name). For example: "jobname" "cpu"

- `--all-rows` | `--ar` (boolean)

  - Return all rows of data, no matter how many. Overrides --row-start and --row-end

- `--row-start` | `--rs` (number)

  - The first row of the response data to display

    Default value: 1

- `--row-end` | `--re` (number)

  - The last row of the response data to display

    Default value: 100

- `--timeout` | `--to` (number)

  - The number of seconds to wait before timing out

    Default value: 30

#### display options

- `--context-fields` | `--cf` (array)

  - Context fields to display. Defaults to hiding all context

- `--overview` | `-o` (boolean)

  - Display the overview section

- `--info` | `-i` (boolean)

  - Display the information area, if any

- `--pretty` | `-p` (boolean)

  - Display formatted data

- `--blank-if-zero` | `--biz` | `-b` (boolean)

  - Show a blank space instead of '0' values

- `--truncate` | `--tr` (boolean)

  - Truncate displays that are too wide for the console

    Default value: false

#### response format options

- `--response-format-csv` | `--csv` (boolean)

  - Format data as a set of Comma Seperated Values

#### sysview connection options

- `--host` | `-H` (string)

  - The hostname of the SYSVIEW REST API

- `--port` | `-P` (number)

  - The port number of the SYSVIEW REST API

- `--user` | `-u` (string)

  - Your z/OS username used to authenticate to the SYSVIEW REST API

- `--password` | `--pass` | `--pw` (string)

  - Your z/OS password used to authenticate to the SYSVIEW REST API

- `--reject-unauthorized` | `--ru` (boolean)

  - If set, the server certificate is verified against the list of supplied CAs

- `--ssid` (string)

  - SSID of the SYSVIEW instance. Default value: GSVX

    Default value: GSVX

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Do not specify this option if you are not using an API mediation layer.

    Default value: /api/v1

#### Profile Options

- `--sysview-profile` | `--sysview-p` (string)

  - The name of a (sysview) profile to load for this command execution.

- `--sysview-format-profile` | `--sysview-format-p` (string)

  - The name of a (sysview-format) 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

- `--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

- Display the captured ACTIVITY command from MY.CAPTURE.DATASET.:

  - `zowe sysview capture "MY.CAPTURE.DATASET" ACTIVITY`

- Display the Jobname, Jobid, and Status columns of the captured ACTIVITY command on row 3 from MY.CAPTURE.DATASET.:

  - `zowe sysview capture "MY.CAPTURE.DATASET" ACTIVITY --capture-row 3 --fields Jobname Jobid Status`

### zowe › sysview › capture-immediate

Submit a capture request2

#### Usage

zowe sysview capture-immediate <capture-file> [options]

#### Positional Arguments

- `capture-file` (string)

  - The list of SYSVIEW commands to be executed as an Event Capture.This takes the same form as a CAPLIB member.

#### display options

- `--context-fields` | `--cf` (array)

  - Context fields to display. Defaults to hiding all context

#### data options

- `--capture-description` | `--cd` (string)

  - The description of the capture

#### sysview connection options

- `--host` | `-H` (string)

  - The hostname of the SYSVIEW REST API

- `--port` | `-P` (number)

  - The port number of the SYSVIEW REST API

- `--user` | `-u` (string)

  - Your z/OS username used to authenticate to the SYSVIEW REST API

- `--password` | `--pass` | `--pw` (string)

  - Your z/OS password used to authenticate to the SYSVIEW REST API

- `--reject-unauthorized` | `--ru` (boolean)

  - If set, the server certificate is verified against the list of supplied CAs

- `--ssid` (string)

  - SSID of the SYSVIEW instance. Default value: GSVX

    Default value: GSVX

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Do not specify this option if you are not using an API mediation layer.

    Default value: /api/v1

#### Profile Options

- `--sysview-profile` | `--sysview-p` (string)

  - The name of a (sysview) 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

- `--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

- Issues a Capture containing the commands in capture file 'my-capture.txt' with the description 'Top CPU Users':

  - `zowe sysview capture-immediate "./my-capture.txt" --description "Top CPU Users"`

## zowe › sysview › check

Confirm that the SYSVIEW REST server is running on a specified system.

### zowe › sysview › check › status

Confirm that the SYSVIEW REST server is running on a system specified. The command outputs properties of the z/OS system and the SYSVIEW REST server.

#### Usage

zowe sysview check status [options]

#### sysview connection options

- `--host` | `-H` (string)

  - The hostname of the SYSVIEW REST API

- `--port` | `-P` (number)

  - The port number of the SYSVIEW REST API

- `--user` | `-u` (string)

  - Your z/OS username used to authenticate to the SYSVIEW REST API

- `--password` | `--pass` | `--pw` (string)

  - Your z/OS password used to authenticate to the SYSVIEW REST API

- `--reject-unauthorized` | `--ru` (boolean)

  - If set, the server certificate is verified against the list of supplied CAs

- `--ssid` (string)

  - SSID of the SYSVIEW instance. Default value: GSVX

    Default value: GSVX

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Do not specify this option if you are not using an API mediation layer.

    Default value: /api/v1

#### Profile Options

- `--sysview-profile` | `--sysview-p` (string)

  - The name of a (sysview) 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

- `--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

- Report the status of the SYSVIEW REST server that you specified in your default SYSVIEW REST profile:

  - `zowe sysview check status`

- Report the status of the SYSVIEW REST server that you specified in a supplied SYSVIEW REST profile:

  - `zowe sysview check status --sysview-profile SomeSysviewProfileName`

- Report the status of the SYSVIEW REST server that you specified manually via command line:

  - `zowe sysview check status --host myhost --port 443 --user myuser --password mypass`

### zowe › sysview › display

Issue a SYSVIEW primary command and display output, including any messages

#### Usage

zowe sysview display <command-string> [options]

#### Positional Arguments

- `command-string` (string)

  - Command(s) to be issued
    (If more than one command, separated by a semi-colon)
    Example: "ACTIVITY;SORT CPU% D"

#### data options

- `--fields` | `-f` (array)

  - Fields to be returned (by name). For example: "jobname" "cpu"

- `--all-rows` | `--ar` (boolean)

  - Return all rows of data, no matter how many. Overrides --row-start and --row-end

- `--row-start` | `--rs` (number)

  - The first row of the response data to display

    Default value: 1

- `--row-end` | `--re` (number)

  - The last row of the response data to display

    Default value: 100

- `--timeout` | `--to` (number)

  - The number of seconds to wait before timing out

    Default value: 30

#### display options

- `--context-fields` | `--cf` (array)

  - Context fields to display. Defaults to hiding all context

- `--overview` | `-o` (boolean)

  - Display the overview section

- `--info` | `-i` (boolean)

  - Display the information area, if any

- `--pretty` | `-p` (boolean)

  - Display formatted data

- `--blank-if-zero` | `--biz` | `-b` (boolean)

  - Show a blank space instead of '0' values

- `--truncate` | `--tr` (boolean)

  - Truncate displays that are too wide for the console

    Default value: false

#### response format options

- `--response-format-csv` | `--csv` (boolean)

  - Format data as a set of Comma Seperated Values

#### sysview connection options

- `--host` | `-H` (string)

  - The hostname of the SYSVIEW REST API

- `--port` | `-P` (number)

  - The port number of the SYSVIEW REST API

- `--user` | `-u` (string)

  - Your z/OS username used to authenticate to the SYSVIEW REST API

- `--password` | `--pass` | `--pw` (string)

  - Your z/OS password used to authenticate to the SYSVIEW REST API

- `--reject-unauthorized` | `--ru` (boolean)

  - If set, the server certificate is verified against the list of supplied CAs

- `--ssid` (string)

  - SSID of the SYSVIEW instance. Default value: GSVX

    Default value: GSVX

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Do not specify this option if you are not using an API mediation layer.

    Default value: /api/v1

#### Profile Options

- `--sysview-profile` | `--sysview-p` (string)

  - The name of a (sysview) profile to load for this command execution.

- `--sysview-format-profile` | `--sysview-format-p` (string)

  - The name of a (sysview-format) 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

- `--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

- Issue the CSMSTAT command and show the 'message' field from the context area of the response:

  - `zowe sysview display "CSMSTAT" --cf message`

- Issue the JOBSUM command to list jobs starting with "CS" showing only the fields Jobname, Jobid, and Status:

  - `zowe sysview display "jobs CS&VLMC" --fields Jobname Jobid Status`

### zowe › sysview › execute

Issue a SYSVIEW function command and display any messages

#### Usage

zowe sysview execute <command-string> [options]

#### Positional Arguments

- `command-string` (string)

  - Command(s) to be issued
    (If more than one command, separated by a semi-colon)
    Example: "ACTIVITY;SORT CPU% D"

#### display options

- `--context-fields` | `--cf` (array)

  - Context fields to display. Defaults to hiding all context

#### data options

- `--timeout` | `--to` (number)

  - The number of seconds to wait before timing out

    Default value: 30

#### sysview connection options

- `--host` | `-H` (string)

  - The hostname of the SYSVIEW REST API

- `--port` | `-P` (number)

  - The port number of the SYSVIEW REST API

- `--user` | `-u` (string)

  - Your z/OS username used to authenticate to the SYSVIEW REST API

- `--password` | `--pass` | `--pw` (string)

  - Your z/OS password used to authenticate to the SYSVIEW REST API

- `--reject-unauthorized` | `--ru` (boolean)

  - If set, the server certificate is verified against the list of supplied CAs

- `--ssid` (string)

  - SSID of the SYSVIEW instance. Default value: GSVX

    Default value: GSVX

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Do not specify this option if you are not using an API mediation layer.

    Default value: /api/v1

#### Profile Options

- `--sysview-profile` | `--sysview-p` (string)

  - The name of a (sysview) 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

- `--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

- Issue the APFTEST command and display any messages returned from SYSVIEW.:

  - `zowe sysview execute "APFTEST SYS1.LINKLIB SYS001"`

## zowe › zos-console

Interact with z/OSMF console services. Issue z/OS console commands and collect responses. z/OS console services establishes extended MCS (EMCS) consoles on behalf of the user, which are used to issue the commands and collect responses.

Important! Before you use commands in the zos-console command group, ensure that you understand the implications of issuing z/OS console commands in your environment.

## zowe › zos-console › collect

z/OSMF console services provides a command response key upon successful issue of a console command. You can use this key to collect additional console message responses.

### zowe › zos-console › collect › sync-responses

The z/OSMF console REST APIs return a "solicited response key" after successfully issuing a synchronous console command that produces solicited responses. You can use the "solicited response key"on the "sync-responses" command to collect any additional outstanding solicited responses from the console the command was issued.

In general, when issuing a z/OS console command, z/OS applications route responses to the originating console. The command response messages are referred to as "solicited command responses" (i.e. direct responses to the command issued). When issuing a z/OS console command using Zowe CLI, collection of all solicited command responses is attempted by default. However, there is no z/OS mechanism that indicates the total number of response messages that may be produced from a given command. Therefore, the Zowe CLI console APIs return a "solicited response key" that can be used to "follow-up" and collect any additional solicited command responses.

#### Usage

zowe zos-console collect sync-responses <responsekey> [options]

#### Positional Arguments

- `responsekey` (string)

  - The "solicited response key" provided in response to a previously issued console command. Used by the z/OSMF console API to collect any additional outstanding solicited responses from a previously issued console command. Must match regular expression: `^\[a\-zA\-Z0\-9\]\+$`

#### Options

- `--console-name` | `--cn` | `-c` (string)

  - The name of the z/OS extended MCS console to direct the command. You must have the required authority to access the console specified. You may also specify an arbitrary name, if your installation allows dynamic creation of consoles with arbitrary names.

    Allowed values: ^[a-zA-Z0-9]+$

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Collect any outstanding additional solicited response messages:

  - `zowe zos-console collect sync-responses C4866969`

## zowe › zos-console › issue

Issue z/OS console commands and optionally collect responses.

### zowe › zos-console › issue › command

Issue a z/OS console command and print command responses (known as "solicited command responses").

In general, when issuing a z/OS console command, z/OS applications route responses to the originating console. The command response messages are referred to as "solicited command responses" (i.e. direct responses to the command issued). When issuing a z/OS console command using Zowe CLI, collection of all solicited command responses is attempted by default. However, there is no z/OS mechanism that indicates the total number of response messages that may be produced from a given command. Therefore, the Zowe CLI console APIs return a "solicited response key" that can be used to "follow-up" and collect any additional solicited command responses.

Zowe CLI will issue "follow-up" API requests by default to collect any additional outstanding solicited command responses until a request returns no additional responses. At that time, Zowe CLI will attempt a final collection attempt. If no messages are present, the command is complete. If additional messages are present, the process is repeated. However, this does not guarantee that all messages produced in direct response (i.e. solicited) have been collected. The z/OS application may produce additional messages in direct response to your command at some point in the future. You can manually collect additional responses using the "command response key" OR specify additional processing options to, for example, delay collection attempts by a specified interval.

#### Usage

zowe zos-console issue command <commandtext> [options]

#### Positional Arguments

- `commandtext` (string)

  - The z/OS console command to issue.

#### Options

- `--console-name` | `--cn` | `-c` (string)

  - The name of the z/OS extended MCS console to direct the command. You must have the required authority to access the console specified. You may also specify an arbitrary name, if your installation allows dynamic creation of consoles with arbitrary names.

    Allowed values: ^[a-zA-Z0-9]+$

- `--include-details` | `--id` | `-i` (boolean)

  - Include additional details at the end of the Zowe CLI command response, such as the "command response key" and the z/OSMF command response URL.

- `--key-only` | `--ko` | `-k` (boolean)

  - Displays only the "command response key" returned from the z/OSMF console API. You can collect additional messages using the command key with 'zowe zos-console collect sync-responses <key>'. Note that when using this option, you will not be presented with the "first set" of command response messages (if present in the API response). However, you can view them by using the --response-format-json option.

- `--return-first` | `--rf` | `-r` (boolean)

  - Indicates that Zowe CLI should return immediately with the response message set returned in the first z/OSMF API request (even if no responses are present). Using this option may result in partial or no response, but quicker Zowe CLI command response time. The z/OSMF console API has an implicit wait when collecting the first set of console command responses, i.e you will normally receive at least one set of response messages.

- `--solicited-keyword` | `--sk` | `-s` (string)

  - For solicited responses (direct command responses) the response is considered complete if the keyword specified is present. If the keyword is detected, the command will immediately return, meaning the full command response may not be provided. The key only applies to the first request issued, follow up requests do not support searching for the keyword.

- `--sysplex-system` | `--ss` | `--sys` (string)

  - Specifies the z/OS system (LPAR) in the current SYSPLEX (where your target z/OSMF resides) to route the z/OS console command.

- `--wait-to-collect` | `--wtc` | `-w` (number)

  - Indicates that Zowe CLI wait at least the specified number of seconds before attempting to collect additional solicited response messages. If additional messages are collected on "follow-up" requests, the timer is reset until an attempt is made that results in no additional response messages.

- `--follow-up-attempts` | `--fua` | `-a` (number)

  - Number of request attempts if no response returned.

    Default value: 1

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Issue a z/OS console command to display the IPL information for the system:

  - `zowe zos-console issue command "D IPLINFO"`

- Issue a z/OS console command to display the local and coordinated universal time and date:

  - `zowe zos-console issue command "D T"`

- Issue a Db2 command to display information about the status and configuration of DDF:

  - `zowe zos-console issue command "\-DB1G DISPLAY DDF"`

## zowe › zos-files

Manage z/OS data sets, create data sets, and more.

## zowe › zos-files › compare

Compare the contents of z/OS data sets or USS files in your terminal (stdout).

### zowe › zos-files › compare › data-set

Compare the contents of two z/OS data sets in your terminal (stdout).

#### Usage

zowe zos-files compare data-set <dataSetName1> <dataSetName2> [options]

#### Positional Arguments

- `dataSetName1` (string)

  - The name of the first data set you want to compare.

- `dataSetName2` (string)

  - The name of the second data set you want to compare.

#### Options

- `--binary` | `-b` (boolean)

  - Transfer the content of the first data set in binary mode (no EBCDIC to ASCII conversion). If binary mode is set and the binary2 flag is not set then both data sets are transferred in binary mode.

- `--binary2` | `--b2` (boolean)

  - Transfer the content of the second data set in binary mode.

- `--encoding` | `--ec` (string)

  - Transfer the content of the first data set with encoding mode, which means that data conversion is performed using the file encoding specified. If encoding mode is set and the encoding2 flag is not set both data sets are transferred in encoding mode.

- `--encoding2` | `--ec2` (string)

  - Transfer the content of the second data set with encoding mode.

- `--record` | `-r` (boolean)

  - Transfer the content for the first data set in record mode, which means that no data conversion is performed and the record length is prepended to the data. The data transfer process returns each line as-is, without translation. No delimiters are added between records. If encoding mode is set and the encoding2 flag is not set both data sets are transferred in encoding mode. This option conflicts with binary mode.

- `--record2` | `--r2` (boolean)

  - Transfer the content for the second data set in record mode. Conflicts with binary2.

- `--volume-serial` | `--vs` (string)

  - The volume serial (VOLSER) where the first data set resides. You can use this option at any time. However, the VOLSER is required only when the data set is not cataloged on the system. A VOLSER is analogous to a drive name on a PC.

- `--volume-serial2` | `--vs2` (string)

  - The volume serial (VOLSER) where the second data set resides.

- `--seqnum` | `--sn` (boolean)

  - If you are comparing two files that contain sequence numbers, this option controls if the sequences numbers are removed from the end of each string. The default is to keep the sequence numbers. Use the --no-seqnum option to not include them.

    Default value: true

- `--context-lines` | `--cl` (number)

  - The number of context lines that display before and after detected non-matching lines. By default all matching lines display. If you want to limit the amount of data returned to only lines with differences use the context lines option to reduce the matching lines to only those before and after non-matching lines. Using the value of 0 strips all matching lines.

- `--browser-view` | `--bv` (boolean)

  - Opens the diffs between two given files in browser.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Compare the contents of the data set members "sys1.samplib(antptso)" and "sys1.samplib(antxtso)":

  - `zowe zos-files compare data-set "sys1.samplib(antptso)" "sys1.samplib(antxtso)"`

- Compare the contents of the data set members "sys1.samplib(antptso)" and "sys1.samplib(antxtso)" without sequence numbers:

  - `zowe zos-files compare data-set "sys1.samplib(antptso)" "sys1.samplib(antxtso)" --no-seqnum`

### zowe › zos-files › compare › local-file-data-set

Compare the contents of a local file and a z/OS data set in your terminal (stdout).

#### Usage

zowe zos-files compare local-file-data-set <localFilePath> <dataSetName> [options]

#### Positional Arguments

- `localFilePath` (string)

  - The path of the local file you want to compare.

- `dataSetName` (string)

  - The name of the data set you want to compare.

#### Options

- `--binary` | `-b` (boolean)

  - Transfer the content of the first data set in binary mode (no EBCDIC to ASCII conversion). If binary mode is set and the binary2 flag is not set then both data sets are transferred in binary mode.

- `--encoding` | `--ec` (string)

  - Transfer the content of the first data set with encoding mode, which means that data conversion is performed using the file encoding specified. If encoding mode is set and the encoding2 flag is not set both data sets are transferred in encoding mode.

- `--record` | `-r` (boolean)

  - Transfer the content for the first data set in record mode, which means that no data conversion is performed and the record length is prepended to the data. The data transfer process returns each line as-is, without translation. No delimiters are added between records. If encoding mode is set and the encoding2 flag is not set both data sets are transferred in encoding mode. This option conflicts with binary mode.

- `--volume-serial` | `--vs` (string)

  - The volume serial (VOLSER) where the first data set resides. You can use this option at any time. However, the VOLSER is required only when the data set is not cataloged on the system. A VOLSER is analogous to a drive name on a PC.

- `--seqnum` | `--sn` (boolean)

  - If you are comparing two files that contain sequence numbers, this option controls if the sequences numbers are removed from the end of each string. The default is to keep the sequence numbers. Use the --no-seqnum option to not include them.

    Default value: true

- `--context-lines` | `--cl` (number)

  - The number of context lines that display before and after detected non-matching lines. By default all matching lines display. If you want to limit the amount of data returned to only lines with differences use the context lines option to reduce the matching lines to only those before and after non-matching lines. Using the value of 0 strips all matching lines.

- `--browser-view` | `--bv` (boolean)

  - Opens the diffs between two given files in browser.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Compare the contents of the local file and the data set member "./a.txt" and "sys1.samplib(antxtso)":

  - `zowe zos-files compare local-file-data-set "./a.txt" "sys1.samplib(antxtso)"`

- Compare the contents of the local file and the data set member "./a.txt" and "sys1.samplib(antxtso)" without sequence numbers:

  - `zowe zos-files compare local-file-data-set "./a.txt" "sys1.samplib(antxtso)" --no-seqnum`

### zowe › zos-files › compare › local-file-spool-dd

Compare the contents of a local file and a spool dd in your terminal (stdout).

#### Usage

zowe zos-files compare local-file-spool-dd <localFilePath> <spoolDescription> [options]

#### Positional Arguments

- `localFilePath` (string)

  - The path of the local file you want to compare.

- `spoolDescription` (string)

  - The name of the job with the id of spool dd.

#### Options

- `--seqnum` | `--sn` (boolean)

  - If you are comparing two files that contain sequence numbers, this option controls if the sequences numbers are removed from the end of each string. The default is to keep the sequence numbers. Use the --no-seqnum option to not include them.

    Default value: true

- `--context-lines` | `--cl` (number)

  - The number of context lines that display before and after detected non-matching lines. By default all matching lines display. If you want to limit the amount of data returned to only lines with differences use the context lines option to reduce the matching lines to only those before and after non-matching lines. Using the value of 0 strips all matching lines.

- `--browser-view` | `--bv` (boolean)

  - Opens the diffs between two given files in browser.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Compare the contents of a local-file and a spool dd "./a.txt" "jobName:jobId:spoolId":

  - `zowe zos-files compare local-file-spool-dd "./a.txt" "jobName:jobId:spoolId"`

- Compare the contents of a local-file and a spool dd "./a.txt" "jobName:jobId:spoolId" without sequence numbers:

  - `zowe zos-files compare local-file-spool-dd "./a.txt" "jobName:jobId:spoolId" --no-seqnum`

### zowe › zos-files › compare › local-file-uss-file

Compare the contents of a local file and a z/OS USS file in your terminal (stdout).

#### Usage

zowe zos-files compare local-file-uss-file <localFilePath> <ussFilePath> [options]

#### Positional Arguments

- `localFilePath` (string)

  - The path of the local file you want to compare.

- `ussFilePath` (string)

  - The path of the USS file set you want to compare.

#### Options

- `--binary` | `-b` (boolean)

  - Transfer the content of the first data set in binary mode (no EBCDIC to ASCII conversion). If binary mode is set and the binary2 flag is not set then both data sets are transferred in binary mode.

- `--encoding` | `--ec` (string)

  - Transfer the content of the first data set with encoding mode, which means that data conversion is performed using the file encoding specified. If encoding mode is set and the encoding2 flag is not set both data sets are transferred in encoding mode.

- `--seqnum` | `--sn` (boolean)

  - If you are comparing two files that contain sequence numbers, this option controls if the sequences numbers are removed from the end of each string. The default is to keep the sequence numbers. Use the --no-seqnum option to not include them.

    Default value: true

- `--context-lines` | `--cl` (number)

  - The number of context lines that display before and after detected non-matching lines. By default all matching lines display. If you want to limit the amount of data returned to only lines with differences use the context lines option to reduce the matching lines to only those before and after non-matching lines. Using the value of 0 strips all matching lines.

- `--browser-view` | `--bv` (boolean)

  - Opens the diffs between two given files in browser.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Compare the contents of the local file and the USS file "./a.txt" and "/u/user/test.txt":

  - `zowe zos-files compare local-file-uss-file "./a.txt" "/u/user/test.txt"`

- Compare the contents of the local file and the USS file "./a.txt" and "/u/user/test.txt" without sequence numbers:

  - `zowe zos-files compare local-file-uss-file "./a.txt" "/u/user/test.txt" --no-seqnum`

### zowe › zos-files › compare › spool-dd

Compare the contents of two spool dds in your terminal (stdout).

#### Usage

zowe zos-files compare spool-dd <spoolDescription1> <spoolDescription2> [options]

#### Positional Arguments

- `spoolDescription1` (string)

  - The name of the first job with the id of spool dd.

- `spoolDescription2` (string)

  - The name of the second job with the id of spool dd.

#### Options

- `--context-lines` | `--cl` (number)

  - The number of context lines that display before and after detected non-matching lines. By default all matching lines display. If you want to limit the amount of data returned to only lines with differences use the context lines option to reduce the matching lines to only those before and after non-matching lines. Using the value of 0 strips all matching lines.

- `--browser-view` | `--bv` (boolean)

  - Opens the diffs between two given files in browser.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Compare the contents of the two spool dds "jobName1:jobId1:spoolId1" "jobName2:jobId2:spoolId2":

  - `zowe zos-files compare spool-dd "jobName1:jobId1:spoolId1" "jobName2:jobId2:spoolId2"`

- Compare the contents of the two spool dds "jobName1:jobId1:spoolId1" "jobName2:jobId2:spoolId2" without sequence numbers:

  - `zowe zos-files compare spool-dd "jobName1:jobId1:spoolId1" "jobName2:jobId2:spoolId2" --no-seqnum`

### zowe › zos-files › compare › uss-files

Compare the contents of two z/OS USS files in your terminal (stdout).

#### Usage

zowe zos-files compare uss-files <ussFilePath1> <ussFilePath2> [options]

#### Positional Arguments

- `ussFilePath1` (string)

  - The path of the first USS file you want to compare.

- `ussFilePath2` (string)

  - The path of the second USS file you want to compare.

#### Options

- `--binary` | `-b` (boolean)

  - Transfer the content of the first data set in binary mode (no EBCDIC to ASCII conversion). If binary mode is set and the binary2 flag is not set then both data sets are transferred in binary mode.

- `--binary2` | `--b2` (boolean)

  - Transfer the content of the second data set in binary mode.

- `--encoding` | `--ec` (string)

  - Transfer the content of the first data set with encoding mode, which means that data conversion is performed using the file encoding specified. If encoding mode is set and the encoding2 flag is not set both data sets are transferred in encoding mode.

- `--encoding2` | `--ec2` (string)

  - Transfer the content of the second data set with encoding mode.

- `--seqnum` | `--sn` (boolean)

  - If you are comparing two files that contain sequence numbers, this option controls if the sequences numbers are removed from the end of each string. The default is to keep the sequence numbers. Use the --no-seqnum option to not include them.

    Default value: true

- `--context-lines` | `--cl` (number)

  - The number of context lines that display before and after detected non-matching lines. By default all matching lines display. If you want to limit the amount of data returned to only lines with differences use the context lines option to reduce the matching lines to only those before and after non-matching lines. Using the value of 0 strips all matching lines.

- `--browser-view` | `--bv` (boolean)

  - Opens the diffs between two given files in browser.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Compare the contents of the USS file "/u/user/test.txt" and "/u/user/test.txt":

  - `zowe zos-files compare uss-files "/u/user/test.txt" "/u/user/test.txt"`

- Compare the contents of the USS file "/u/user/test.txt" and "/u/user/test.txt" without sequence numbers:

  - `zowe zos-files compare uss-files "/u/user/test.txt" "/u/user/test.txt" --no-seqnum`

## zowe › zos-files › copy

Copy a data set.

### zowe › zos-files › copy › data-set

Copy a data set/partitioned data set to another data set/partitioned data set.

#### Usage

zowe zos-files copy data-set <fromDataSetName> <toDataSetName> [options]

#### Positional Arguments

- `fromDataSetName` (string)

  - The name of the data set that you want to copy from

- `toDataSetName` (string)

  - The name of the data set that you want to copy to

#### Options

- `--overwrite` | `-o` | `--ow` (boolean)

  - Specify this option as true if you wish to replace the entire target data set with the source data set. All members, even those with no naming overlap, will be overwritten

- `--replace` | `--rep` (boolean)

  - Specify this option as true if you wish to replace members with identical names in the target data set

- `--safe-replace` | `--safe-rep` | `--sr` (boolean)

  - Specify this option as true if you wish to replace members with identical names or the content of the target data set. This option will prompt to confirm.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Copy the data set named 'USER.FROM.SET' to the data set named 'USER.TO.SET':

  - `zowe zos-files copy data-set "USER.FROM.SET" "USER.TO.SET"`

- Copy the data set member named 'USER.FROM.SET(MEM1)' to the data set member named 'USER.TO.SET(MEM2)':

  - `zowe zos-files copy data-set "USER.FROM.SET(mem1)" "USER.TO.SET(mem2)"`

- Copy the data set named 'USER.FROM.SET' to the data set member named 'USER.TO.SET(MEM2)':

  - `zowe zos-files copy data-set "USER.FROM.SET" "USER.TO.SET(mem2)"`

- Copy the data set member named 'USER.FROM.SET(MEM1)' to the data set named 'USER.TO.SET':

  - `zowe zos-files copy data-set "USER.FROM.SET(mem1)" "USER.TO.SET"`

- Copy the data set named 'USER.FROM.SET' to the data set named 'USER.TO.SET' and replace members with identical names:

  - `zowe zos-files copy data-set "USER.FROM.SET" "USER.TO.SET" --replace`

- Copy the partitioned data set named 'TEST.PDS1' to the partitioned data set named 'TEST.PDS2':

  - `zowe zos-files copy data-set "USER.FROM.SET" "USER.TO.SET" --safe-replace`

- Copy the partitioned data set named 'USER.FROM.SET' to the partitioned data set named 'USER.FROM.SET' and overwrite the original contents:

  - `zowe zos-files copy data-set "USER.FROM.SET" "USER.TO.SET" --overwrite`

### zowe › zos-files › copy › data-set-cross-lpar

Copy a data set to another data set on a specified LPAR.

#### Usage

zowe zos-files copy data-set-cross-lpar <fromDataSetName> <toDataSetName> [options]

#### Positional Arguments

- `fromDataSetName` (string)

  - The name of the data set that you want to copy from

- `toDataSetName` (string)

  - The name of the data set that you want to copy to. If the data set does not exist it will be allocated automatically

#### Options

- `--replace` | `--rep` (boolean)

  - Specify this option as true if you wish to replace the target data set if it already exists.

- `--target-data-class` | `--tdc` (string)

  - The SMS data class to use for the allocation of the target data set.

- `--target-host` | `--th` (string)

  - The target z/OSMF server host name.

- `--target-management-class` | `--tmc` (string)

  - The SMS management class to use for the allocation of the target data set.

- `--target-password` | `--tpw` (string)

  - The target z/OSMF password, which can be the same as your TSO password.

- `--target-port` | `--tp` (number)

  - The target z/OSMF server port.

- `--target-storage-class` | `--tsc` (string)

  - The SMS storage class to use for the allocation of the target data set.

- `--target-token-type` | `--ttt` (string)

  - The value of the token to pass to the API for the target system.

- `--target-token-value` | `--ttv` (string)

  - The type of token to get and use for the API for the target system.

- `--target-user` | `--tu` (string)

  - The target z/OSMF user name, which can be the same as your TSO login.

- `--target-volume-serial` | `--tvs` | `--target-volser` (string)

  - The volume serial (VOLSER) on which you want the target data set to be placed.

- `--target-zosmf-profile` | `--t-zosmf-p` | `--target-zosmf-p` (string)

  - The name of a z/OSMF profile to load for the target host.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Copy the data set named 'USER.FROM.SET' to the data set named 'USER.TO.SET' using the --target-zosmf-p option to specify the target host using a zosmf profile:

  - `zowe zos-files copy data-set-cross-lpar "USER.FROM.SET" "USER.TO.SET" --target-zosmf-profile SYS1`

- Copy the data set member named 'USER.FROM.SET(MEM1)' to the data set member named 'USER.TO.SET(MEM2)':

  - `zowe zos-files copy data-set-cross-lpar "USER.FROM.SET(mem1)" "USER.TO.SET(mem2)" --target-zosmf-profile SYS1`

- Copy the data set named 'USER.FROM.SET' to the data set member named 'USER.TO.SET(MEM2)':

  - `zowe zos-files copy data-set-cross-lpar "USER.FROM.SET" "USER.TO.SET(mem2)" --target-zosmf-profile SYS1`

- Copy the data set member named 'USER.FROM.SET(MEM1)' to the data set named 'USER.TO.SET' using the --target-host, --target-user, and --target-password options:

  - `zowe zos-files copy data-set-cross-lpar "USER.FROM.SET(mem1)" "USER.TO.SET" --target-host sys1.com --target-user user1 --target-password pass1`

## zowe › zos-files › create

Create data sets.

### zowe › zos-files › create › data-set

Create data sets based on the properties of an existing data set.

#### Usage

zowe zos-files create data-set <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set that you want to create

#### Options

- `--attributes` | `-a` (boolean)

  - Show the full allocation attributes

- `--block-size` | `--bs` | `--blksize` (number)

  - The block size for the data set (for example, 6160)

- `--data-class` | `--dc` (string)

  - The SMS data class to use for the allocation

- `--data-set-type` | `--dst` | `--dsntype` (string)

  - The data set type (BASIC, EXTPREF, EXTREQ, HFS, LARGE, PDS, LIBRARY, PIPE)

- `--device-type` | `--dt` | `--unit` (string)

  - The device type, also known as 'unit'

- `--directory-blocks` | `--db` | `--dirblks` (number)

  - The number of directory blocks (for example, 25)

- `--like` | `--lk` (string)

  - Name of an existing data set to base your new data set's properties on

- `--management-class` | `--mc` (string)

  - The SMS management class to use for the allocation

- `--primary-space` | `--ps` (number)

  - The primary space allocation (for example, 5)

- `--record-format` | `--rf` | `--recfm` (string)

  - The record format for the data set (for example, FB for "Fixed Block")

- `--record-length` | `--rl` | `--lrecl` (number)

  - The logical record length. Analogous to the length of a line (for example, 80)

- `--secondary-space` | `--ss` (number)

  - The secondary space allocation (for example, 1)

- `--size` | `--sz` (string)

  - The size of the data set (specified as nCYL or nTRK - where n is the number of cylinders or tracks). Sets the primary allocation (the secondary allocation becomes ~10% of the primary).

- `--storage-class` | `--sc` (string)

  - The SMS storage class to use for the allocation

- `--volume-serial` | `--vs` | `--volser` (string)

  - The volume serial (VOLSER) on which you want the data set to be placed. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Create a data set with default parameters and like flag:

  - `zowe zos-files create data-set NEW.DATASET --like EXISTING.DATASET`

- Create a data set with default parameters and like flag and lrecl flag:

  - `zowe zos-files create data-set NEW.DATASET --like EXISTING.DATASET --record-length 1024`

- Create a data set with type LIBRARY:

  - `zowe zos-files create data-set NEW.DATASET --data-set-type LIBRARY`

### zowe › zos-files › create › data-set-binary

Create executable data sets.

#### Usage

zowe zos-files create data-set-binary <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set that you want to create

#### Options

- `--attributes` | `-a` (boolean)

  - Show the full allocation attributes

- `--block-size` | `--bs` | `--blksize` (number)

  - The block size for the data set (for example, 6160)

    Default value: 27998

- `--data-class` | `--dc` (string)

  - The SMS data class to use for the allocation

- `--data-set-type` | `--dst` | `--dsntype` (string)

  - The data set type (BASIC, EXTPREF, EXTREQ, HFS, LARGE, PDS, LIBRARY, PIPE)

- `--device-type` | `--dt` | `--unit` (string)

  - The device type, also known as 'unit'

- `--directory-blocks` | `--db` | `--dirblks` (number)

  - The number of directory blocks (for example, 25)

    Default value: 25

- `--management-class` | `--mc` (string)

  - The SMS management class to use for the allocation

- `--primary-space` | `--ps` (number)

  - The primary space allocation (for example, 5)

    Default value: 10

- `--record-format` | `--rf` | `--recfm` (string)

  - The record format for the data set (for example, FB for "Fixed Block")

    Default value: U

- `--record-length` | `--rl` | `--lrecl` (number)

  - The logical record length. Analogous to the length of a line (for example, 80)

    Default value: 27998

- `--secondary-space` | `--ss` (number)

  - The secondary space allocation (for example, 1)

- `--size` | `--sz` (string)

  - The size of the data set (specified as nCYL or nTRK - where n is the number of cylinders or tracks). Sets the primary allocation (the secondary allocation becomes ~10% of the primary).

- `--storage-class` | `--sc` (string)

  - The SMS storage class to use for the allocation

- `--volume-serial` | `--vs` | `--volser` (string)

  - The volume serial (VOLSER) on which you want the data set to be placed. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Create an empty binary partitioned data set (PDS) with default parameters:

  - `zowe zos-files create data-set-binary NEW.BINARY.DATASET`

- Create an empty binary PDSE using data set type LIBRARY:

  - `zowe zos-files create data-set-binary NEW.BINARY.DATASET --data-set-type LIBRARY`

### zowe › zos-files › create › data-set-c

Create data sets for C code programming.

#### Usage

zowe zos-files create data-set-c <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set that you want to create

#### Options

- `--attributes` | `-a` (boolean)

  - Show the full allocation attributes

- `--block-size` | `--bs` | `--blksize` (number)

  - The block size for the data set (for example, 6160)

    Default value: 32760

- `--data-class` | `--dc` (string)

  - The SMS data class to use for the allocation

- `--data-set-type` | `--dst` | `--dsntype` (string)

  - The data set type (BASIC, EXTPREF, EXTREQ, HFS, LARGE, PDS, LIBRARY, PIPE)

- `--device-type` | `--dt` | `--unit` (string)

  - The device type, also known as 'unit'

- `--directory-blocks` | `--db` | `--dirblks` (number)

  - The number of directory blocks (for example, 25)

    Default value: 25

- `--management-class` | `--mc` (string)

  - The SMS management class to use for the allocation

- `--primary-space` | `--ps` (number)

  - The primary space allocation (for example, 5)

    Default value: 1

- `--record-format` | `--rf` | `--recfm` (string)

  - The record format for the data set (for example, FB for "Fixed Block")

    Default value: VB

- `--record-length` | `--rl` | `--lrecl` (number)

  - The logical record length. Analogous to the length of a line (for example, 80)

    Default value: 260

- `--secondary-space` | `--ss` (number)

  - The secondary space allocation (for example, 1)

- `--size` | `--sz` (string)

  - The size of the data set (specified as nCYL or nTRK - where n is the number of cylinders or tracks). Sets the primary allocation (the secondary allocation becomes ~10% of the primary).

- `--storage-class` | `--sc` (string)

  - The SMS storage class to use for the allocation

- `--volume-serial` | `--vs` | `--volser` (string)

  - The volume serial (VOLSER) on which you want the data set to be placed. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Create an empty C code PDS with default parameters:

  - `zowe zos-files create data-set-c NEW.CCODE.DATASET`

- Create an empty C code PDSE using data set type LIBRARY:

  - `zowe zos-files create data-set-c NEW.CCODE.DATASET --data-set-type LIBRARY`

### zowe › zos-files › create › data-set-classic

Create classic data sets (JCL, HLASM, CBL, etc...).

#### Usage

zowe zos-files create data-set-classic <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set that you want to create

#### Options

- `--attributes` | `-a` (boolean)

  - Show the full allocation attributes

- `--block-size` | `--bs` | `--blksize` (number)

  - The block size for the data set (for example, 6160)

    Default value: 6160

- `--data-class` | `--dc` (string)

  - The SMS data class to use for the allocation

- `--data-set-type` | `--dst` | `--dsntype` (string)

  - The data set type (BASIC, EXTPREF, EXTREQ, HFS, LARGE, PDS, LIBRARY, PIPE)

- `--device-type` | `--dt` | `--unit` (string)

  - The device type, also known as 'unit'

- `--directory-blocks` | `--db` | `--dirblks` (number)

  - The number of directory blocks (for example, 25)

    Default value: 25

- `--management-class` | `--mc` (string)

  - The SMS management class to use for the allocation

- `--primary-space` | `--ps` (number)

  - The primary space allocation (for example, 5)

    Default value: 1

- `--record-format` | `--rf` | `--recfm` (string)

  - The record format for the data set (for example, FB for "Fixed Block")

    Default value: FB

- `--record-length` | `--rl` | `--lrecl` (number)

  - The logical record length. Analogous to the length of a line (for example, 80)

    Default value: 80

- `--secondary-space` | `--ss` (number)

  - The secondary space allocation (for example, 1)

- `--size` | `--sz` (string)

  - The size of the data set (specified as nCYL or nTRK - where n is the number of cylinders or tracks). Sets the primary allocation (the secondary allocation becomes ~10% of the primary).

- `--storage-class` | `--sc` (string)

  - The SMS storage class to use for the allocation

- `--volume-serial` | `--vs` | `--volser` (string)

  - The volume serial (VOLSER) on which you want the data set to be placed. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Create an empty z/OS 'classic' PDS with default parameters:

  - `zowe zos-files create data-set-classic NEW.CLASSIC.DATASET`

- Create an empty z/OS 'classic' PDSE using data set type LIBRARY:

  - `zowe zos-files create data-set-classic NEW.CLASSIC.DATASET --data-set-type LIBRARY`

### zowe › zos-files › create › data-set-partitioned

Create partitioned data sets (PDS).

#### Usage

zowe zos-files create data-set-partitioned <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set that you want to create

#### Options

- `--allocation-space-unit` | `--asu` (string)

  - The allocation unit (for example, CYL for Cylinders)

    Default value: CYL

- `--attributes` | `-a` (boolean)

  - Show the full allocation attributes

- `--block-size` | `--bs` | `--blksize` (number)

  - The block size for the data set (for example, 6160)

    Default value: 6160

- `--data-class` | `--dc` (string)

  - The SMS data class to use for the allocation

- `--data-set-type` | `--dst` | `--dsntype` (string)

  - The data set type (BASIC, EXTPREF, EXTREQ, HFS, LARGE, PDS, LIBRARY, PIPE)

- `--device-type` | `--dt` | `--unit` (string)

  - The device type, also known as 'unit'

- `--directory-blocks` | `--db` | `--dirblks` (number)

  - The number of directory blocks (for example, 25)

    Default value: 5

- `--management-class` | `--mc` (string)

  - The SMS management class to use for the allocation

- `--primary-space` | `--ps` (number)

  - The primary space allocation (for example, 5)

    Default value: 1

- `--record-format` | `--rf` | `--recfm` (string)

  - The record format for the data set (for example, FB for "Fixed Block")

    Default value: FB

- `--record-length` | `--rl` | `--lrecl` (number)

  - The logical record length. Analogous to the length of a line (for example, 80)

    Default value: 80

- `--secondary-space` | `--ss` (number)

  - The secondary space allocation (for example, 1)

- `--size` | `--sz` (string)

  - The size of the data set (specified as nCYL or nTRK - where n is the number of cylinders or tracks). Sets the primary allocation (the secondary allocation becomes ~10% of the primary).

- `--storage-class` | `--sc` (string)

  - The SMS storage class to use for the allocation

- `--volume-serial` | `--vs` | `--volser` (string)

  - The volume serial (VOLSER) on which you want the data set to be placed. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Create an empty PDS with default parameters:

  - `zowe zos-files create data-set-partitioned NEW.PDS.DATASET`

- Create an empty PDSE using data set type LIBRARY:

  - `zowe zos-files create data-set-partitioned NEW.PDSE.DATASET --data-set-type LIBRARY`

### zowe › zos-files › create › data-set-sequential

Create physical sequential data sets (PS).

#### Usage

zowe zos-files create data-set-sequential <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set that you want to create

#### Options

- `--attributes` | `-a` (boolean)

  - Show the full allocation attributes

- `--block-size` | `--bs` | `--blksize` (number)

  - The block size for the data set (for example, 6160)

    Default value: 6160

- `--data-class` | `--dc` (string)

  - The SMS data class to use for the allocation

- `--data-set-type` | `--dst` | `--dsntype` (string)

  - The data set type (BASIC, EXTPREF, EXTREQ, HFS, LARGE, PDS, LIBRARY, PIPE)

- `--device-type` | `--dt` | `--unit` (string)

  - The device type, also known as 'unit'

- `--directory-blocks` | `--db` | `--dirblks` (number)

  - The number of directory blocks (for example, 25)

- `--management-class` | `--mc` (string)

  - The SMS management class to use for the allocation

- `--primary-space` | `--ps` (number)

  - The primary space allocation (for example, 5)

    Default value: 1

- `--record-format` | `--rf` | `--recfm` (string)

  - The record format for the data set (for example, FB for "Fixed Block")

    Default value: FB

- `--record-length` | `--rl` | `--lrecl` (number)

  - The logical record length. Analogous to the length of a line (for example, 80)

    Default value: 80

- `--secondary-space` | `--ss` (number)

  - The secondary space allocation (for example, 1)

- `--size` | `--sz` (string)

  - The size of the data set (specified as nCYL or nTRK - where n is the number of cylinders or tracks). Sets the primary allocation (the secondary allocation becomes ~10% of the primary).

- `--storage-class` | `--sc` (string)

  - The SMS storage class to use for the allocation

- `--volume-serial` | `--vs` | `--volser` (string)

  - The volume serial (VOLSER) on which you want the data set to be placed. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Create an empty physical sequential data set with default parameters:

  - `zowe zos-files create data-set-sequential NEW.PS.DATASET`

- Create a LARGE format sequential data set with default parameters:

  - `zowe zos-files create data-set-sequential --data-set-type LARGE`

### zowe › zos-files › create › data-set-vsam

Create a VSAM cluster.

#### Usage

zowe zos-files create data-set-vsam <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set in which to create a VSAM cluster

#### Options

- `--attributes` | `-a` (boolean)

  - Show the full allocation attributes

- `--data-class` | `--dc` (string)

  - The SMS data class to use for the allocation

- `--data-set-organization` | `--dso` | `--dsorg` (string)

  - The data set organization.

    Default value: INDEXED
    Allowed values: INDEXED, IXD, LINEAR, LIN, NONINDEXED, NIXD, NUMBERED, NUMD, ZFS

- `--management-class` | `--mc` (string)

  - The SMS management class to use for the allocation

- `--retain-for` | `--rf` (number)

  - The number of days that the VSAM cluster will be retained on the system. You can delete the cluster at any time when neither retain-for nor retain-to is specified.

- `--retain-to` | `--rt` (string)

  - The earliest date that a command without the PURGE parameter can delete an entry. Specify the expiration date in the form yyyyddd, where yyyy is a four-digit year (maximum value: 2155) and ddd is the three-digit day of the year from 001 through 365 (for non-leap years) or 366 (for leap years). You can delete the cluster at any time when neither retain-for nor retain-to is used. You cannot specify both the 'retain-to' and 'retain-for' options.

- `--secondary-space` | `--ss` (number)

  - The number of items for the secondary space allocation (for example, 840). The type of item allocated is the same as the type used for the '--size' option. If you do not specify a secondary allocation, a value of ~10% of the primary allocation is used.

- `--size` | `--sz` (string)

  - The primary size to allocate for the VSAM cluster. Specify size as the number of items to allocate (nItems). You specify the type of item by keyword.

    Default value: 840KB

- `--storage-class` | `--sc` (string)

  - The SMS storage class to use for the allocation

- `--volumes` | `-v` (string)

  - The storage volumes on which to allocate a VSAM cluster. Specify a single volume by its volume serial (VOLSER). To specify more than one volume, enclose the option in double-quotes and separate each VOLSER with a space. You must specify the volumes option when your cluster is not SMS-managed.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Create a VSAM data set named "SOME.DATA.SET.NAME" using default values of INDEXED, 840 KB primary storage and 84 KB secondary storage:

  - `zowe zos-files create data-set-vsam SOME.DATA.SET.NAME`

- Create a 5 MB LINEAR VSAM data set named "SOME.DATA.SET.NAME" with 1 MB of secondary space. Show the properties of the data set when it is created:

  - `zowe zos-files create data-set-vsam SOME.DATA.SET.NAME --data-set-organization LINEAR --size 5MB --secondary-space 1 --attributes`

- Create a VSAM data set named "SOME.DATA.SET.NAME", which is retained for 100 days:

  - `zowe zos-files create data-set-vsam SOME.DATA.SET.NAME --retain-for 100`

### zowe › zos-files › create › uss-directory

Create a UNIX directory.

#### Usage

zowe zos-files create uss-directory <ussPath> [options]

#### Positional Arguments

- `ussPath` (string)

  - The name of the directory that you want to create.

#### Options

- `--mode` | `-m` (string)

  - Specifies the file permission bits to use when creating the directory.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Create a USS directory named "testDir" :

  - `zowe zos-files create uss-directory testDir`

- Create a USS directory named "testDir" with mode "rwxrwxrwx" :

  - `zowe zos-files create uss-directory testDir --mode rwxrwxrwx`

### zowe › zos-files › create › uss-file

Create a UNIX file.

#### Usage

zowe zos-files create uss-file <ussPath> [options]

#### Positional Arguments

- `ussPath` (string)

  - The name of the file that you want to create.

#### Options

- `--mode` | `-m` (string)

  - Specifies the file permission bits to use when creating the file.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Create a USS file named "test.ext" :

  - `zowe zos-files create uss-file text.txt`

- Create a USS file named "text.txt" with mode "rwxrwxrwx" :

  - `zowe zos-files create uss-file text.txt --mode rwxrwxrwx`

### zowe › zos-files › create › zos-file-system

Create a z/OS file system.

#### Usage

zowe zos-files create zos-file-system <fileSystemName> [options]

#### Positional Arguments

- `fileSystemName` (string)

  - The name of the file system to create.

#### Options

- `--cyls-pri` | `--cp` (number)

  - The number of primary cylinders to allocate for the ZFS.

    Default value: 10

- `--cyls-sec` | `--cs` (number)

  - The number of secondary cylinders to allocate for the ZFS.

    Default value: 2

- `--data-class` | `--dc` (string)

  - The SMS data class to use for the allocation

- `--group` | `-g` (string)

  - The z/OS group ID or GID for the group of the ZFS root directory.

- `--management-class` | `--mc` (string)

  - The SMS management class to use for the allocation

- `--owner` | `-o` (string)

  - The z/OS user ID or UID for the owner of the ZFS root directory.

- `--perms` | `-p` (number)

  - The permissions code for the ZFS root directory.

    Default value: 755

- `--storage-class` | `--sc` (string)

  - The SMS storage class to use for the allocation

- `--timeout` | `-t` (number)

  - The number of seconds to wait for the underlying "zfsadm format" command to complete. If this command times out, the ZFS may have been created but not formatted correctly.

    Default value: 20

- `--volumes` | `-v` (array)

  - The storage volumes on which to allocate the z/OS file system. Specify a single volume by its volume serial (VOLSER). To specify more than one volume, separate each VOLSER with a space. You must specify the volumes option when your cluster is not SMS-managed.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Create a ZFS named "HLQ.MYNEW.ZFS" using default values of 755 permissions, 10 primary and 2 secondary cylinders allocated, and a timeout of 20 seconds:

  - `zowe zos-files create zos-file-system HLQ.MYNEW.ZFS`

- Create a ZFS with 100 primary and 10 secondary cylinders allocated:

  - `zowe zos-files create zos-file-system HLQ.MYNEW.ZFS --cyls-pri 100 --cyls-sec 10`

- Create a ZFS specifying the volumes that should be used:

  - `zowe zos-files create zos-file-system HLQ.MYNEW.ZFS --volumes ZFS001 ZFS002`

## zowe › zos-files › delete

Delete a data set or Unix System Services file.

### zowe › zos-files › delete › data-set

Delete a data set or data set member permanently.

#### Usage

zowe zos-files delete data-set <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set that you want to delete

#### Required Options

- `--for-sure` | `-f` (boolean)

  - Specify this option to confirm that you want to delete the data set permanently.

#### Options

- `--ignore-not-found` | `-i` | `--inf` (boolean)

  - Suppress errors if the data set does not exist.

- `--volume` | `--vol` (string)

  - The volume serial (VOLSER) where the data set resides. The option is required only when the data set is not catalogued on the system.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Delete the data set named 'ibmuser.cntl':

  - `zowe zos-files delete data-set "ibmuser.cntl" --for-sure`

- Delete the data set member named 'ibmuser.cntl(mem)':

  - `zowe zos-files delete data-set "ibmuser.cntl(mem)" --for-sure`

- Quietly delete a data set, suppressing errors if it doesn't exist:

  - `zowe zos-files delete data-set "ibmuser.cntl(mem)" --for-sure --ignore-not-found`

### zowe › zos-files › delete › data-set-vsam

Delete a VSAM cluster permanently.

#### Usage

zowe zos-files delete data-set-vsam <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the VSAM cluster that you want to delete

#### Options

- `--erase` | `-e` (boolean)

  - Specify this option to overwrite the data component for the cluster with binary zeros. This option is ignored if the NOERASE attribute was specified when the cluster was defined or altered.

    Default value: false

- `--ignore-not-found` | `-i` | `--inf` (boolean)

  - Suppress errors if the VSAM data set does not exist.

- `--purge` | `-p` (boolean)

  - Specify this option to delete the VSAM cluster regardless of its retention period or date.

    Default value: false

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Required Options

- `--for-sure` | `-f` (boolean)

  - Specify this option to confirm that you want to delete the VSAM cluster permanently.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Delete the VSAM data set named 'ibmuser.cntl.vsam':

  - `zowe zos-files delete data-set-vsam "ibmuser.cntl.vsam" --for-sure`

- Quietly delete all VSAM data sets that match 'ibmuser.AAA.**.FFF' ignoring not-found errors:

  - `zowe zos-files delete data-set-vsam "ibmuser.AAA.**.FFF" --for-sure`

- Delete a non-expired VSAM data set named 'ibmuser.cntl.vsam':

  - `zowe zos-files delete data-set-vsam "ibmuser.cntl.vsam" --for-sure --purge`

- Delete an expired VSAM data set named 'ibmuser.cntl.vsam' by overwriting the components with zeros:

  - `zowe zos-files delete data-set-vsam "ibmuser.cntl.vsam" --for-sure --erase`

- Quietly delete all VSAM data sets that match 'ibmuser.AAA.**.FFF' ignoring not-found errors:

  - `zowe zos-files delete data-set-vsam "ibmuser.cntl.vsam" --for-sure --ignore-not-found`

### zowe › zos-files › delete › migrated-data-set

Delete migrated data sets.

#### Usage

zowe zos-files delete migrated-data-set <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the migrated data set you want to delete.

#### Options

- `--wait` | `-w` (boolean)

  - If true then the function waits for completion of the request. If false (default) the request is queued.

    Default value: false

- `--purge` | `-p` (boolean)

  - If true then the function uses the PURGE=YES on ARCHDEL request. If false (default) the function uses the PURGE=NO on ARCHDEL request.

    Default value: false

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Delete a migrated data set using default options:

  - `zowe zos-files delete migrated-data-set "USER.DATA.SET"`

### zowe › zos-files › delete › uss-file

Delete a Unix Systems Services (USS) file or directory permanently.

#### Usage

zowe zos-files delete uss-file <fileName> [options]

#### Positional Arguments

- `fileName` (string)

  - The name of the file or directory that you want to delete

#### Required Options

- `--for-sure` | `-f` (boolean)

  - Specify this option to confirm that you want to delete the file or directory permanently.

#### Options

- `--recursive` | `-r` (boolean)

  - Delete directories recursively.

- `--ignore-not-found` | `-i` | `--inf` (boolean)

  - Suppress errors if the file does not exist.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Delete the empty directory '/u/ibmuser/testcases':

  - `zowe zos-files delete uss-file "/a/ibmuser/testcases" --for-sure`

- Delete the file named '/a/ibmuser/my_text.txt':

  - `zowe zos-files delete uss-file "/a/ibmuser/testcases/my_text.txt" --for-sure`

- Recursively delete the directory named '/u/ibmuser/testcases':

  - `zowe zos-files delete uss-file "/a/ibmuser/testcases" --recursive --for-sure`

- Quietly delete a file, suppressing errors if the file doesn't exist:

  - `zowe zos-files delete uss-file "/a/ibmuser/testcases" --for-sure --ignore-not-found`

### zowe › zos-files › delete › zos-file-system

Delete a z/OS file system permanently.

#### Usage

zowe zos-files delete zos-file-system <fileSystemName> [options]

#### Positional Arguments

- `fileSystemName` (string)

  - The name of the z/OS file system that you want to delete.

#### Required Options

- `--for-sure` | `-f` (boolean)

  - Specify this option to confirm that you want to delete the ZFS permanently.

#### Options

- `--ignore-not-found` | `-i` | `--inf` (boolean)

  - Suppress errors if the z/OS file does not exist.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Delete the z/OS file system 'HLQ.MYNEW.ZFS':

  - `zowe zos-files delete zos-file-system "HLQ.MYNEW.ZFS" --for-sure`

- Quietly delete a z/OS file, suppressing errors if the file doesn't exist:

  - `zowe zos-files delete zos-file-system "HLQ.MYNEW.ZFS" --for-sure --ignore-not-found`

## zowe › zos-files › download

Download content from z/OS data sets and USS files to your PC.

### zowe › zos-files › download › all-members

Download all members from a partitioned data set to a local folder.

#### Usage

zowe zos-files download all-members <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set from which you want to download members

#### Options

- `--binary` | `-b` (boolean)

  - Download the file content in binary mode, which means that no data conversion is performed. The data transfer process returns each line as-is, without translation. No delimiters are added between records.

- `--directory` | `-d` (string)

  - The directory to where you want to save the members. The command creates the directory for you when it does not already exist. By default, the command creates a folder structure based on the data set qualifiers. For example, the data set ibmuser.new.cntl's members are downloaded to ibmuser/new/cntl).

- `--encoding` | `--ec` (string)

  - Download the file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--extension` | `-e` (string)

  - Save the local files with a specified file extension. For example, .txt. Or "" for no extension. When no extension is specified, .txt is used as the default file extension.

- `--fail-fast` | `--ff` (boolean)

  - Set this option to false to continue downloading data set members if one or more fail.

    Default value: true

- `--max-concurrent-requests` | `--mcr` (number)

  - Specifies the maximum number of concurrent z/OSMF REST API requests to download members. Increasing the value results in faster downloads. However, increasing the value increases resource consumption on z/OS and can be prone to errors caused by making too many concurrent requests. If the download process encounters an error, the following message displays:
    The maximum number of TSO address spaces have been created. When you specify 0, Zowe CLI attempts to download all members at once without a maximum number of concurrent requests.

    Default value: 1

- `--preserve-original-letter-case` | `--po` (boolean)

  - Specifies if the automatically generated directories and files use the original letter case.

    Default value: false

- `--record` | `-r` (boolean)

  - Download the file content in record mode, which means that no data conversion is performed and the record length is prepended to the data. The data transfer process returns each line as-is, without translation. No delimiters are added between records. Conflicts with binary.

- `--volume-serial` | `--vs` (string)

  - The volume serial (VOLSER) where the data set resides. You can use this option at any time. However, the VOLSER is required only when the data set is not cataloged on the system. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Download the members of the data set "ibmuser.loadlib" in binary mode to the directory "loadlib/":

  - `zowe zos-files download all-members "ibmuser.loadlib" --binary --directory loadlib`

- Download the members of the data set "ibmuser.cntl" in text mode to the directory "jcl/":

  - `zowe zos-files download all-members "ibmuser.cntl" --directory jcl`

### zowe › zos-files › download › all-members-matching

Download all members that match a specific pattern from a partitioned data set to a local folder.

#### Usage

zowe zos-files download all-members-matching <dataSetName> <pattern> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set from which you want to download members

- `pattern` (string)

  - The pattern or patterns to match members against. Also known as 'DSLEVEL'. The following special sequences can be used in the pattern:
    %: matches any single character
    *: matches any number of characters within a member
    You can specify multiple patterns separated by commas, for example "Mem*, Test*"

#### Options

- `--binary` | `-b` (boolean)

  - Download the file content in binary mode, which means that no data conversion is performed. The data transfer process returns each line as-is, without translation. No delimiters are added between records.

- `--directory` | `-d` (string)

  - The directory to where you want to save the members. The command creates the directory for you when it does not already exist. By default, the command creates a folder structure based on the data set qualifiers. For example, the data set ibmuser.new.cntl's members are downloaded to ibmuser/new/cntl).

- `--encoding` | `--ec` (string)

  - Download the file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--exclude-patterns` | `--ep` (string)

  - Exclude data sets that match these DSLEVEL patterns. Any data sets that match this pattern will not be downloaded.

- `--extension` | `-e` (string)

  - Save the local files with a specified file extension. For example, .txt. Or "" for no extension. When no extension is specified, .txt is used as the default file extension.

- `--fail-fast` | `--ff` (boolean)

  - Set this option to false to continue downloading data set members if one or more fail.

    Default value: true

- `--max-concurrent-requests` | `--mcr` (number)

  - Specifies the maximum number of concurrent z/OSMF REST API requests to download members. Increasing the value results in faster downloads. However, increasing the value increases resource consumption on z/OS and can be prone to errors caused by making too many concurrent requests. If the download process encounters an error, the following message displays:
    The maximum number of TSO address spaces have been created. When you specify 0, Zowe CLI attempts to download all members at once without a maximum number of concurrent requests.

    Default value: 1

- `--preserve-original-letter-case` | `--po` (boolean)

  - Specifies if the automatically generated directories and files use the original letter case.

    Default value: false

- `--record` | `-r` (boolean)

  - Download the file content in record mode, which means that no data conversion is performed and the record length is prepended to the data. The data transfer process returns each line as-is, without translation. No delimiters are added between records. Conflicts with binary.

- `--volume-serial` | `--vs` (string)

  - The volume serial (VOLSER) where the data set resides. You can use this option at any time. However, the VOLSER is required only when the data set is not cataloged on the system. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Download the members of the data set "ibmuser.loadlib" that begin with "Test" to the directory "loadlib/":

  - `zowe zos-files download all-members-matching "ibmuser.loadlib" "Test*" --directory loadlib`

- Download the members of the data set "ibmuser.cntl" that begin with "Test" & "M" to the directory "output",
  and exclude members that begin with "M2".:

  - `zowe zos-files download all-members-matching "ibmuser.cntl" "test*,M*" --exclude-patterns "M2*" --directory output`

### zowe › zos-files › download › data-set

Download content from a z/OS data set to a local file.

#### Usage

zowe zos-files download data-set <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set that you want to download

#### Options

- `--binary` | `-b` (boolean)

  - Download the file content in binary mode, which means that no data conversion is performed. The data transfer process returns each line as-is, without translation. No delimiters are added between records.

- `--encoding` | `--ec` (string)

  - Download the file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--extension` | `-e` (string)

  - Save the local files with a specified file extension. For example, .txt. Or "" for no extension. When no extension is specified, .txt is used as the default file extension.

- `--file` | `-f` (string)

  - The path to the local file where you want to download the content. When you omit the option, the command generates a file name automatically for you.

- `--preserve-original-letter-case` | `--po` (boolean)

  - Specifies if the automatically generated directories and files use the original letter case.

    Default value: false

- `--record` | `-r` (boolean)

  - Download the file content in record mode, which means that no data conversion is performed and the record length is prepended to the data. The data transfer process returns each line as-is, without translation. No delimiters are added between records. Conflicts with binary.

- `--volume-serial` | `--vs` (string)

  - The volume serial (VOLSER) where the data set resides. You can use this option at any time. However, the VOLSER is required only when the data set is not cataloged on the system. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Download the data set "ibmuser.loadlib(main)" in binary mode to the local file "main.obj":

  - `zowe zos-files download data-set "ibmuser.loadlib(main)" --binary --file main.obj`

### zowe › zos-files › download › data-sets-matching

Download all data sets that match a DSLEVEL pattern (see help below). You can use several options to qualify which data sets will be skipped and how the downloaded files will be structured. Data sets that are neither physical sequential nor partitioned data sets (with members) will be excluded.

#### Usage

zowe zos-files download data-sets-matching <pattern> [options]

#### Positional Arguments

- `pattern` (string)

  - The pattern or patterns to match data sets against. Also known as 'DSLEVEL'. The following special sequences can be used in the pattern:
    %: matches any single character
    *: matches any number of characters within a data set name qualifier (e.g. "ibmuser.j*.old" matches "ibmuser.jcl.old" but not "ibmuser.jcl.very.old")
    **: matches any number of characters within any number of data set name qualifiers (e.g. "ibmuser.**.old" matches both "ibmuser.jcl.old" and "ibmuser.jcl.very.old")
    However, the pattern cannot begin with any of these sequences. You can specify multiple patterns separated by commas, for example "ibmuser.**.cntl,ibmuser.**.jcl"

#### Options

- `--binary` | `-b` (boolean)

  - Download the file content in binary mode, which means that no data conversion is performed. The data transfer process returns each line as-is, without translation. No delimiters are added between records.

- `--directory` | `-d` (string)

  - The directory to where you want to save the members. The command creates the directory for you when it does not already exist. By default, the command creates a folder structure based on the data set qualifiers. For example, the data set ibmuser.new.cntl's members are downloaded to ibmuser/new/cntl).

- `--encoding` | `--ec` (string)

  - Download the file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--exclude-patterns` | `--ep` (string)

  - Exclude data sets that match these DSLEVEL patterns. Any data sets that match this pattern will not be downloaded.

- `--extension` | `-e` (string)

  - Save the local files with a specified file extension. For example, .txt. Or "" for no extension. When no extension is specified, .txt is used as the default file extension.

- `--extension-map` | `--em` (string)

  - Use this option to map data set names that match your pattern to the desired extension. A comma delimited key value pairing (e.g. "cntl=.jcl,cpgm=.c" to map the last segment of each data set (also known as the "low level qualifier" to the desired local file extension).

- `--fail-fast` | `--ff` (boolean)

  - Set this option to false to continue downloading data set members if one or more fail.

    Default value: true

- `--max-concurrent-requests` | `--mcr` (number)

  - Specifies the maximum number of concurrent z/OSMF REST API requests to download members. Increasing the value results in faster downloads. However, increasing the value increases resource consumption on z/OS and can be prone to errors caused by making too many concurrent requests. If the download process encounters an error, the following message displays:
    The maximum number of TSO address spaces have been created. When you specify 0, Zowe CLI attempts to download all members at once without a maximum number of concurrent requests.

    Default value: 1

- `--preserve-original-letter-case` | `--po` (boolean)

  - Specifies if the automatically generated directories and files use the original letter case.

    Default value: false

- `--record` | `-r` (boolean)

  - Download the file content in record mode, which means that no data conversion is performed and the record length is prepended to the data. The data transfer process returns each line as-is, without translation. No delimiters are added between records. Conflicts with binary.

- `--volume-serial` | `--vs` (string)

  - The volume serial (VOLSER) where the data set resides. You can use this option at any time. However, the VOLSER is required only when the data set is not cataloged on the system. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Download all data sets beginning with "ibmuser" and ending with ".cntl" or ".jcl" to the local directory "jcl" to files with the extension ".jcl":

  - `zowe zos-files download data-sets-matching "ibmuser.**.cntl, ibmuser.**.jcl" --directory jcl --extension .jcl`

- Download all data sets that begin with "ibmuser.public.project" or "ibmuser.project.private", excluding those that end in "lib" to the local directory "project", providing a custom mapping of data set low level qualifier to local file extension:

  - `zowe zos-files download data-sets-matching "ibmuser.public.project.*, ibmuser.project.private.*" --exclude-patterns "ibmuser.public.**.*lib" --directory project --extension-map cpgm=c,asmpgm=asm,java=java,chdr=c,jcl=jcl,cntl=jcl`

### zowe › zos-files › download › uss-directory

Download content from a USS directory to a local directory on your PC.

#### Usage

zowe zos-files download uss-directory <ussDirName> [options]

#### Positional Arguments

- `ussDirName` (string)

  - The name of the USS directory you want to download

#### Options

- `--attributes` | `--attrs` (local file path)

  - Path of an attributes file to control how files are downloaded.

- `--binary` | `-b` (boolean)

  - Download the file content in binary mode, which means that no data conversion is performed. The data transfer process returns each line as-is, without translation. No delimiters are added between records.

- `--depth` (number)

  - Filters content in USS based on the number of directories to traverse down.

- `--directory` | `-d` (string)

  - The directory to where you want to save the files. The command creates the directory for you when it does not already exist. By default, the command downloads the files to the current directory.

- `--encoding` | `--ec` (string)

  - Download the file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--fail-fast` | `--ff` (boolean)

  - Set this option to false to continue downloading USS files if one or more fail.

    Default value: true

- `--filesys` (boolean)

  - Filters content in USS based on the filesystem the data is on. true - all filesystems, false - same filesystem as search directory.

- `--group` (string)

  - Filters content in USS based on the owning group name or ID.

- `--include-hidden` | `--ih` (boolean)

  - Include hidden files and folders that have names beginning with a dot.

- `--max-concurrent-requests` | `--mcr` (number)

  - Specifies the maximum number of concurrent z/OSMF REST API requests to download files. Increasing the value results in faster downloads. However, increasing the value increases resource consumption on z/OS and can be prone to errors caused by making too many concurrent requests. If the download process encounters an error, the following message displays:
    The maximum number of TSO address spaces have been created. When you specify 0, Zowe CLI attempts to download all files at once without a maximum number of concurrent requests.

    Default value: 1

- `--max-length` | `--max` (number)

  - The option --max-length specifies the maximum number of items to return. Skip this parameter to return all items. If you specify an incorrect value, the parameter returns up to 1000 items.

- `--mtime` (string)

  - Filters content in USS based on the last modification time. N - specify an exact number of days, +N - older than N days, -N - newer than N days

- `--name` (string)

  - Filters files in USS based on the name of the file or directory.

- `--overwrite` | `--ow` (boolean)

  - Overwrite files that already exist in your local environment.

- `--owner` (string)

  - Filters content in USS based on the owning user name or ID.

- `--perm` (string)

  - Filters content in USS based on the octal permissions string.

- `--size` (string)

  - Filters content in USS based on the size. Default units are bytes. Add a suffix of K for kilobytes, M for megabytes, or G for gigabytes. N - specify an exact file size, +N - larger than N size, -N - smaller than N size

- `--symlinks` (boolean)

  - Filters content in USS based on whether or not to follow symbolic links. true - report symlinks, false - follow symlinks

- `--type` (string)

  - Filters content in USS based on the type of content. f - regular file, d - directory, l - symbolic link, p - FIFO named pipe, s - socket

    Allowed values: f, d, l, p, s

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Download the directory "/a/ibmuser" to "./" in binary mode:

  - `zowe zos-files download uss-directory /a/ibmuser --binary`

- Download the directory "/a/ibmuser" to "./localDir":

  - `zowe zos-files download uss-directory /a/ibmuser --directory localDir`

- Download files from the directory "/a/ibmuser" that match the name "*.log" and were modified within the last day:

  - `zowe zos-files download uss-directory /a/ibmuser --name "*.log" --mtime -1`

### zowe › zos-files › download › uss-file

Download content from a USS file to a local file on your PC.

#### Usage

zowe zos-files download uss-file <ussFileName> [options]

#### Positional Arguments

- `ussFileName` (string)

  - The name of the USS file you want to download

#### Options

- `--attributes` | `--attrs` (local file path)

  - Path of an attributes file to control how files are downloaded.

- `--binary` | `-b` (boolean)

  - Download the file content in binary mode, which means that no data conversion is performed. The data transfer process returns each line as-is, without translation. No delimiters are added between records.

- `--encoding` | `--ec` (string)

  - Download the file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--file` | `-f` (string)

  - The path to the local file where you want to download the content. When you omit the option, the command generates a file name automatically for you.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Download the file "/a/ibmuser/my_text.txt" to ./my_text.txt:

  - `zowe zos-files download uss-file "/a/ibmuser/my_text.txt" --file ./my_text.txt`

- Download the file "/a/ibmuser/MyJava.class" to "java/MyJava.class" in binary mode:

  - `zowe zos-files download uss-file "/a/ibmuser/MyJava.class" --binary --file "java/MyJava.class"`

- Download the file "/a/ibmuser/MyJava.class" to "java/MyJava.class" using a .zosattributes file:

  - `zowe zos-files download uss-file "/a/ibmuser/MyJava.class" --attributes /path/to/.zosattributes --file "java/MyJava.class"`

## zowe › zos-files › edit

Edit the contents of a data set or USS file with your terminal and default editor.

### zowe › zos-files › edit › data-set

Edit content from a z/OS data set with your terminal and default editor.

#### Usage

zowe zos-files edit data-set <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set you want to edit.

#### Options

- `--editor` | `--ed` (string)

  - Editor that overrides the default editor for this file type. Set the option to the editor's executable file location or the program's name: ie "--editor notepad"

- `--extension` | `--ext` (string)

  - Set the file extension of the file for editing to leverage an editor's file-type-specific formatting: ie "--extension jcl"

- `--binary` | `-b` (boolean)

  - Transfer the file content in binary mode (no EBCDIC to ASCII conversion).

- `--encoding` | `--ec` (string)

  - Transfer the file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Edit the contents of the data set member "ibmuser.cntl(iefbr14)":

  - `zowe zos-files edit data-set ibmuser.cntl(iefbr14) --editor notepad`

- Edit the contents of the data set member "ibmuser.cntl(iefbr14)":

  - `zowe zos-files edit data-set ibmuser.cntl(iefbr14) --editor C:\Windows\System32\Notepad.exe`

- Edit the contents of the data set member "ibmuser.jcl(iefbr14)" and set extension as "jcl":

  - `zowe zos-files edit data-set ibmuser.jcl(iefbr14) --binary`

### zowe › zos-files › edit › uss-file

Edit content from a Unix System Services (USS) file with your terminal and default editor.

#### Usage

zowe zos-files edit uss-file <ussFilePath> [options]

#### Positional Arguments

- `ussFilePath` (string)

  - The path of the USS file you want to edit.

#### Options

- `--editor` | `--ed` (string)

  - Editor that overrides the default editor for this file type. Set the option to the editor's executable file location or the program's name: ie "--editor notepad"

- `--binary` | `-b` (boolean)

  - Transfer the file content in binary mode (no EBCDIC to ASCII conversion).

- `--encoding` | `--ec` (string)

  - Transfer the file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Edit the contents of the USS file "/a/ibmuser/my_text.txt" in notepad:

  - `zowe zos-files edit uss-file /a/ibmuser/my_text.txt --editor notepad`

- Edit the contents of the USS file "/a/ibmuser/my_text.txt" in notepad:

  - `zowe zos-files edit uss-file /a/ibmuser/my_text.txt --editor C:\Windows\System32\Notepad.exe`

- Edit the contents of the USS file "/a/ibmuser/my_jcl.jcl" with binary flag set:

  - `zowe zos-files edit uss-file /a/ibmuser/my_text.txt --binary`

## zowe › zos-files › invoke

Invoke z/OS utilities such as Access Method Services (AMS).

### zowe › zos-files › invoke › ams-file

Submit control statements for execution by Access Method Services (IDCAMS). You can use IDCAMS to create VSAM data sets (CSI, ZFS, etc...), delete data sets, and more. You must format the control statements exactly as the IDCAMS utility expects. For more information about control statements, see the IBM publication 'z/OS DFSMS Access Method Services Commands'.

#### Usage

zowe zos-files invoke ams-file <controlStatementsFile> [options]

#### Positional Arguments

- `controlStatementsFile` (string)

  - The path to a file that contains IDCAMS control statements. Ensure that your file does not contain statements that are longer than 255 characters (maximum allowed length).

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Options

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Reads the specified file and submits the controls statements:

  - `zowe zos-files invoke ams-file "./path/to/file/MyControlStatements.idcams"`

### zowe › zos-files › invoke › ams-statements

Submit control statements for execution by Access Method Services (IDCAMS). You can use IDCAMS to create VSAM data sets (CSI, ZFS, etc...), delete data sets, and more. You must format the control statements exactly as the IDCAMS utility expects. For more information about control statements, see the IBM publication 'z/OS DFSMS Access Method Services Commands'.

#### Usage

zowe zos-files invoke ams-statements <controlStatements> [options]

#### Positional Arguments

- `controlStatements` (string)

  - The IDCAMS control statement that you want to submit. Zowe CLI attempts to split the inline control statement at 255 characters.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Options

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Defines a cluster named 'DUMMY.VSAM.CLUSTER':

  - `zowe zos-files invoke ams-statements "DEFINE CLUSTER ( NAME (DUMMY.VSAM.CLUSTER) CYL(1 1))"`

- Deletes a cluster named 'DUMMY.VSAM.CLUSTER':

  - `zowe zos-files invoke ams-statements "DELETE DUMMY.VSAM.CLUSTER CLUSTER"`

## zowe › zos-files › list

List data sets and data set members. Optionally, you can list their details and attributes.

### zowe › zos-files › list › all-members

List all members of a partitioned data set. To view additional information about each member, use the --attributes option under the Options section of this help text.

#### Usage

zowe zos-files list all-members <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set for which you want to list the members

#### Options

- `--attributes` | `-a` (boolean)

  - Display more information about each member. Data sets with an undefined record format display information related to executable modules. Variable and fixed block data sets display information about when the members were created and modified.

- `--max-length` | `--max` (number)

  - The option --max-length specifies the maximum number of items to return. Skip this parameter to return all items. If you specify an incorrect value, the parameter returns up to 1000 items.

- `--pattern` (string)

  - The option --pattern specifies the match pattern used when listing members in a data set. The default is to match against all members, e.g. "*".

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Show members of the data set "ibmuser.asm":

  - `zowe zos-files list all-members "ibmuser.asm"`

- Show attributes of members of the data set "ibmuser.cntl":

  - `zowe zos-files list all-members "ibmuser.cntl" --attributes`

- Show the first 5 members of the data set "ibmuser.cntl":

  - `zowe zos-files list all-members "ibmuser.cntl" --max 5`

- Show the first 4 members of the data set "ibmuser.cntl" matching an input pattern":

  - `zowe zos-files list all-members "sys1.maclib" --pattern IJK* --max 4`

### zowe › zos-files › list › data-set

List data sets that match a pattern in the data set name.

#### Usage

zowe zos-files list data-set <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name or pattern of the data set that you want to list

#### Options

- `--attributes` | `-a` (boolean)

  - Display more information about each member. Data sets with an undefined record format display information related to executable modules. Variable and fixed block data sets display information about when the members were created and modified.

- `--max-length` | `--max` (number)

  - The option --max-length specifies the maximum number of items to return. Skip this parameter to return all items. If you specify an incorrect value, the parameter returns up to 1000 items.

- `--volume-serial` | `--vs` (string)

  - The volume serial (VOLSER) where the data set resides. You can use this option at any time. However, the VOLSER is required only when the data set is not cataloged on the system. A VOLSER is analogous to a drive name on a PC.

- `--start` | `-s` (string)

  - An optional search parameter that specifies the first data set name to return in the response document.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Show the data set "ibmuser.asm":

  - `zowe zos-files list data-set "ibmuser.asm"`

- Show attributes of the data set "ibmuser.cntl":

  - `zowe zos-files list data-set "ibmuser.cntl" --attributes`

- Show all data sets of the user "ibmuser":

  - `zowe zos-files list data-set "ibmuser.*"`

- Show attributes of all data sets of the user "ibmuser":

  - `zowe zos-files list data-set "ibmuser.*" --attributes`

- Show the first 5 data sets of the user "ibmuser":

  - `zowe zos-files list data-set "ibmuser.cntl" --max 5`

### zowe › zos-files › list › file-system

List all mounted filesystems, or the specific filesystem mounted at a given path, or the filesystem with a given filesystem name.

#### Usage

zowe zos-files list file-system [options]

#### Options

- `--max-length` | `--max` (number)

  - The option --max-length specifies the maximum number of items to return. Skip this parameter to return all items. If you specify an incorrect value, the parameter returns up to 1000 items.

- `--fsname` | `-f` (string)

  - Specifies the name of the mounted file system. This option and --path are mutually exclusive.

- `--path` | `-p` (string)

  - Specifies the path where the file system is mounted. This option and --fsname are mutually exclusive.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- To list all mounted filesystems:

  - `zowe zos-files list file-system`

- To list filesystems mounted to a specific path:

  - `zowe zos-files list file-system --path /a/ibmuser`

- To list filesystems mounted with a specific name:

  - `zowe zos-files list file-system --fsname MY.ZFS`

### zowe › zos-files › list › uss-files

List USS files and directories in a UNIX file path.

#### Usage

zowe zos-files list uss-files <path> [options]

#### Positional Arguments

- `path` (string)

  - The directory containing the files and directories to be listed

#### Options

- `--max-length` | `--max` (number)

  - The option --max-length specifies the maximum number of items to return. Skip this parameter to return all items. If you specify an incorrect value, the parameter returns up to 1000 items.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Show the files and directories in path '/u/ibmuser':

  - `zowe zos-files list uss-files "/u/ibmuser"`

- Show the files and directories in path '/u/ibmuser displaying only the file or directory name:

  - `zowe zos-files list uss-files "/u/ibmuser" --response-format-filter name`

- Show the files and directories in path '/u/ibmuser' displaying the headers associated with the file detail:

  - `zowe zos-files list uss-files "/u/ibmuser" --response-format-header`

## zowe › zos-files › migrate

Migrate data sets.

### zowe › zos-files › migrate › data-set

Migrate a data set.

#### Usage

zowe zos-files migrate data-set <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set you want to migrate.

#### Options

- `--wait` | `-w` (boolean)

  - If true then the function waits for completion of the request. If false (default) the request is queued.

    Default value: false

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Migrate a data set using default options:

  - `zowe zos-files migrate data-set "USER.DATA.SET"`

## zowe › zos-files › mount

Mount z/OS UNIX file systems, such as HFS, ZFS, and more. This connects you to USS file systems.

### zowe › zos-files › mount › file-system

Mount a UNIX file system on a specified directory.

#### Usage

zowe zos-files mount file-system <fileSystemName> <mountPoint> [options]

#### Positional Arguments

- `fileSystemName` (string)

  - The name of the file system to mount.

- `mountPoint` (string)

  - The directory to use as a mount point.

#### Options

- `--fs-type` | `--ft` (string)

  - Specify the file system type that you are going to mount. The name must match the TYPE operand on a FILESYSTYPE statement in the BPXPRMxx parmlib member for the file system.

    Default value: ZFS

- `--mode` | `-m` (string)

  - Specify the mode for mounting the file system (rdonly - read-only, rdwr - read/write).

    Default value: rdonly
    Allowed values: rdonly, rdwr

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Mount a z/OS file system using default options:

  - `zowe zos-files mount file-system MY.ZFS /a/ibmuser/mountdir`

- Mount a hierarchical file system with write access:

  - `zowe zos-files mount file-system MY.HFS /a/ibmuser/mountdir --fs-type HFS --mode rdwr`

## zowe › zos-files › recall

Recall migrated data sets.

### zowe › zos-files › recall › data-set

Recall a migrated data set.

#### Usage

zowe zos-files recall data-set <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set you want to recall.

#### Options

- `--wait` | `-w` (boolean)

  - If true then the function waits for completion of the request. If false (default) the request is queued.

    Default value: false

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Recall a data set using default options:

  - `zowe zos-files recall data-set "USER.DATA.SET"`

## zowe › zos-files › rename

Rename a data set or member.

### zowe › zos-files › rename › data-set

Rename a data set.

#### Usage

zowe zos-files rename data-set <beforeDataSetName> <afterDataSetName> [options]

#### Positional Arguments

- `beforeDataSetName` (string)

  - The name of the data set that you want to rename.

- `afterDataSetName` (string)

  - The name you want to rename the data set to.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Options

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Rename the data set named 'USER.BEFORE.SET' to 'USER.AFTER.SET.':

  - `zowe zos-files rename data-set "USER.BEFORE.SET" "USER.AFTER.SET"`

### zowe › zos-files › rename › data-set-member

Rename a data set member.

#### Usage

zowe zos-files rename data-set-member <dataSetName> <beforeMemberName> <afterMemberName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set the member belongs to.

- `beforeMemberName` (string)

  - The name of the data set member that you want to rename.

- `afterMemberName` (string)

  - The name you want to rename the data set member to.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Options

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- In the data set 'USER.DATA.SET', rename the member named 'MEM1' to 'MEM2'.:

  - `zowe zos-files rename data-set-member "USER.DATA.SET" "MEM1" "MEM2`

## zowe › zos-files › search

Search files for a search term.

### zowe › zos-files › search › data-sets

Search all data sets and PDS members that match the data set name for a search term.

#### Usage

zowe zos-files search data-sets <pattern> <searchString> [options]

#### Positional Arguments

- `pattern` (string)

  - The pattern to match data sets against. Also known as 'DSLEVEL'. The following special sequences can be used in the pattern:
    %: matches any single character
    *: matches any number of characters within a data set name qualifier (e.g. "ibmuser.j*.old" matches "ibmuser.jcl.old" but not "ibmuser.jcl.very.old")
    **: matches any number of characters within any number of data set name qualifiers (e.g. "ibmuser.**.old" matches both "ibmuser.jcl.old" and "ibmuser.jcl.very.old")
    However, the pattern cannot begin with any of these sequences. You can specify multiple patterns separated by commas, for example "ibmuser.**.cntl,ibmuser.**.jcl"

- `searchString` (string)

  - The parameter to search for.

#### Options

- `--case-sensitive` | `--cs` (boolean)

  - The search should be case sensitive

    Default value: false

- `--encoding` | `--ec` (string)

  - Search the file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--mainframe-search` | `--ms` (boolean)

  - Perform a preliminary search on the mainframe, reducing network traffic. However, this option does not work with data sets that contain binary data. This option should be omitted if any data sets may be in binary format. Failure to do so may result in an incomplete set of search results.

    Default value: false

- `--max-concurrent-requests` | `--mcr` (number)

  - Specifies the maximum number of concurrent z/OSMF REST API requests to search files. Increasing the value results in faster searches. However, increasing the value increases resource consumption on z/OS and can be prone to errors caused by making too many concurrent requests.

    Default value: 1

- `--timeout` | `--to` (number)

  - The number of seconds to search before timing out.

- `--regex` | `--re` (boolean)

  - Whether the search string is a regular expression.

    Default value: false

- `--search-exact-name` | `--sen` (boolean)

  - The search pattern must exactly match the data set name.

    Default value: false

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Search all of IBMUSER's data sets for 'ZOWE':

  - `zowe zos-files search data-sets 'IBMUSER.*' 'ZOWE'`

- Search all of IBMUSER's data sets for 'ZOWE' in uppercase only:

  - `zowe zos-files search data-sets 'IBMUSER.*' 'ZOWE' --case-sensitive`

- Search all of IBMUSER's data sets for 'ZOWE', and time out in 1 minute:

  - `zowe zos-files search data-sets 'IBMUSER.*' 'ZOWE' --timeout 60`

- Search all of IBMUSER's data sets for 'ZOWE', and perform 8 parallel tasks:

  - `zowe zos-files search data-sets 'IBMUSER.*' 'ZOWE' --max-concurrent-requests 8`

- Search all of IBMUSER's data sets using a regular expression:

  - `zowe zos-files search data-sets 'IBMUSER.*' 'Z([A-Za-z]){3}' --regex`

## zowe › zos-files › unmount

Unmount file systems, such as HFS, ZFS, and more. This disconnects you from USS file systems.

### zowe › zos-files › unmount › file-system

Unmount a UNIX file system.

#### Usage

zowe zos-files unmount file-system <fileSystemName> [options]

#### Positional Arguments

- `fileSystemName` (string)

  - The name of the file system to unmount.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Options

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Unmount a mounted file system:

  - `zowe zos-files unmount file-system MY.FS`

## zowe › zos-files › upload

Upload the contents of a file to data sets.

### zowe › zos-files › upload › dir-to-pds

Upload files from a local directory to a partitioned data set (PDS).

#### Usage

zowe zos-files upload dir-to-pds <inputdir> <dataSetName> [options]

#### Positional Arguments

- `inputdir` (string)

  - The path for a local directory that you want to upload to a PDS

- `dataSetName` (string)

  - The name of the partitioned data set to which you want to upload the files

#### Options

- `--binary` | `-b` (boolean)

  - Data content in binary mode, which means that no data conversion is performed. The data transfer process returns each record as-is, without translation. No delimiters are added between records.

- `--encoding` | `--ec` (string)

  - Data content in encoding mode, which means that data conversion is performed according to the encoding specified.

- `--migrated-recall` | `--mr` (string)

  - The method by which migrated data set is handled. By default, a migrated data set is recalled synchronously. You can specify the following values: wait, nowait, error

    Default value: nowait

- `--record` | `-r` (boolean)

  - Data content in record mode, which means that no data conversion is performed and the record length is prepended to the data. The data transfer process returns each line as-is, without translation. No delimiters are added between records. Conflicts with binary.

- `--volume-serial` | `--vs` (string)

  - The volume serial (VOLSER) where the data set resides. You can use this option at any time. However, the VOLSER is required only when the data set is not cataloged on the system. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Upload a directory named "src" to a PDS named "ibmuser.src":

  - `zowe zos-files upload dir-to-pds "src" "ibmuser.src"`

- Upload a directory named "src" to a migrated PDS named "ibmuser.src" and wait for it to be recalled:

  - `zowe zos-files upload dir-to-pds "src" "ibmuser.src" --migrated-recall wait`

### zowe › zos-files › upload › dir-to-uss

Upload a local directory to a USS directory.

An optional .zosattributes file in the source directory can be used to control file conversion and tagging.

An example .zosattributes file:
# pattern local-encoding remote-encoding
# Don't upload the node_modules directory
node_modules -
# Don't upload files that start with periods
.* -
# Upload jpg images in binary
*.jpg binary binary
# Convert CICS Node.js profiles to EBCDIC
*.profile ISO8859-1 EBCDIC

Lines starting with the ‘#’ character are comments. Each line can specify up to three positional attributes:

- A pattern to match a set of files. Pattern-matching syntax follows the same rules as those that apply in .gitignore files (note that negated patterns that begin with ‘!’ are not supported). See https://git-scm.com/docs/gitignore#_pattern_format.
- A local-encoding to identify a file’s encoding on the local workstation. If '-' is specified for local-encoding,files that match the pattern are not transferred.
- A remote-encoding to specify the file’s desired character set on USS. This attribute must either match the local encoding or be set to EBCDIC. If set to EBCDIC, files are transferred in text mode and converted, otherwise they are transferred in binary mode. Remote files are tagged either with the remote encoding or as binary.

A .zosattributes file can either be placed in the top-level directory you want to upload, or its location can be specified by using the --attributes parameter. .zosattributes files that are placed in nested directories are ignored.

#### Usage

zowe zos-files upload dir-to-uss <inputDir> <USSDir> [options]

#### Positional Arguments

- `inputDir` (string)

  - The local directory path that you want to upload to a USS directory

- `USSDir` (string)

  - The name of the USS directory to which you want to upload the local directory

#### Options

- `--binary` | `-b` (boolean)

  - Data content in binary mode, which means that no data conversion is performed. The data transfer process returns each record as-is, without translation. No delimiters are added between records.

- `--recursive` | `-r` (boolean)

  - Upload all directories recursively.

- `--binary-files` | `--bf` (string)

  - Comma separated list of file names to be uploaded in binary mode. Use this option when you upload a directory in default ASCII mode, but you want to specify certain files to be uploaded in binary mode. All files matching specified file names will be uploaded in binary mode. If a .zosattributes file (or equivalent file specified via --attributes) is present, --binary-files will be ignored.

- `--ascii-files` | `--af` (string)

  - Comma separated list of file names to be uploaded in ASCII mode. Use this option when you upload a directory with --binary/-b flag, but you want to specify certain files to be uploaded in ASCII mode. All files matching specified file names will be uploaded in ASCII mode. If a .zosattributes file (or equivalent file specified via --attributes) is present, --ascii-files will be ignored.

- `--attributes` | `--attrs` (string)

  - Path of an attributes file to control how files are uploaded.

- `--max-concurrent-requests` | `--mcr` (number)

  - Specifies the maximum number of concurrent z/OSMF REST API requests to upload files. Increasing the value results in faster uploads. However, increasing the value increases resource consumption on z/OS and can be prone to errors caused by making too many concurrent requests. If the upload process encounters an error, the following message displays:
    The maximum number of TSO address spaces have been created. When you specify 0, Zowe CLI attempts to upload all members at once without a maximum number of concurrent requests.

    Default value: 1

- `--include-hidden` | `--ih` (boolean)

  - Include hidden files and folders that have names beginning with a dot.

- `--encoding` | `--ec` (string)

  - Data content in encoding mode, which means that data conversion is performed according to the encoding specified.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Upload all files from the "local_dir" directory to the "/a/ibmuser/my_dir" USS directory:

  - `zowe zos-files upload dir-to-uss "local_dir" "/a/ibmuser/my_dir"`

- Upload all files from the "local_dir" directory and all its sub-directories, to the "/a/ibmuser/my_dir" USS directory:

  - `zowe zos-files upload dir-to-uss "local_dir" "/a/ibmuser/my_dir" --recursive`

- Upload all files from the "local_dir" directory to the "/a/ibmuser/my_dir" USS directory in default ASCII mode, while specifying a list of file names (without path) to be uploaded in binary mode:

  - `zowe zos-files upload dir-to-uss "local_dir" "/a/ibmuser/my_dir" --binary-files "myFile1.exe,myFile2.exe,myFile3.exe"`

- Upload all files from the "local_dir" directory to the "/a/ibmuser/my_dir" USS directory in binary mode, while specifying a list of file names (without path) to be uploaded in ASCII mode:

  - `zowe zos-files upload dir-to-uss "local_dir" "/a/ibmuser/my_dir" --binary --ascii-files "myFile1.txt,myFile2.txt,myFile3.txt"`

- Recursively upload all files from the "local_dir" directory to the "/a/ibmuser/my_dir" USS directory, specifying files to ignore and file encodings in the local file my_global_attributes:

  - `zowe zos-files upload dir-to-uss "local_dir" "/a/ibmuser/my_dir" --recursive --attributes my_global_attributes`

- Upload all files from the "local_dir" directory to the "/a/ibmuser/my_dir" USS directory using IBM-1047 encoding:

  - `zowe zos-files upload dir-to-uss "local_dir" "/a/ibmuser/my_dir" --encoding "IBM-1047"`

### zowe › zos-files › upload › file-to-data-set

Upload the contents of a file to a z/OS data set.

#### Usage

zowe zos-files upload file-to-data-set <inputfile> <dataSetName> [options]

#### Positional Arguments

- `inputfile` (string)

  - The local file that you want to upload to a data set

- `dataSetName` (string)

  - The name of the data set to which you want to upload the file

#### Options

- `--binary` | `-b` (boolean)

  - Data content in binary mode, which means that no data conversion is performed. The data transfer process returns each record as-is, without translation. No delimiters are added between records.

- `--encoding` | `--ec` (string)

  - Data content in encoding mode, which means that data conversion is performed according to the encoding specified.

- `--migrated-recall` | `--mr` (string)

  - The method by which migrated data set is handled. By default, a migrated data set is recalled synchronously. You can specify the following values: wait, nowait, error

    Default value: nowait

- `--record` | `-r` (boolean)

  - Data content in record mode, which means that no data conversion is performed and the record length is prepended to the data. The data transfer process returns each line as-is, without translation. No delimiters are added between records. Conflicts with binary.

- `--volume-serial` | `--vs` (string)

  - The volume serial (VOLSER) where the data set resides. You can use this option at any time. However, the VOLSER is required only when the data set is not cataloged on the system. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Upload file contents to a sequential data set named "ibmuser.ps":

  - `zowe zos-files upload file-to-data-set "file.txt" "ibmuser.ps"`

- Upload file contents to a PDS member named "ibmuser.pds(mem)":

  - `zowe zos-files upload file-to-data-set "file.txt" "ibmuser.pds(mem)"`

- Upload file contents to a migrated data set and wait for it to be recalled:

  - `zowe zos-files upload file-to-data-set "file.txt" "ibmuser.ps" --migrated-recall wait`

### zowe › zos-files › upload › file-to-uss

Upload content to a USS file from local file.

#### Usage

zowe zos-files upload file-to-uss <inputfile> <USSFileName> [options]

#### Positional Arguments

- `inputfile` (string)

  - The local file that you want to upload to a USS file

- `USSFileName` (string)

  - The name of the USS file to which you want to upload the file

#### Options

- `--binary` | `-b` (boolean)

  - Data content in binary mode, which means that no data conversion is performed. The data transfer process returns each record as-is, without translation. No delimiters are added between records.

- `--encoding` | `--ec` (string)

  - Data content in encoding mode, which means that data conversion is performed according to the encoding specified.

- `--attributes` | `--attrs` (string)

  - Path of an attributes file to control how files are uploaded.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Upload to the USS file "/a/ibmuser/my_text.txt" from the file "file.txt":

  - `zowe zos-files upload file-to-uss "file.txt" "/a/ibmuser/my_text.txt"`

### zowe › zos-files › upload › stdin-to-data-set

Upload the content of a stdin to a z/OS data set.

#### Usage

zowe zos-files upload stdin-to-data-set <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set to which you want to upload data

#### Options

- `--binary` | `-b` (boolean)

  - Data content in binary mode, which means that no data conversion is performed. The data transfer process returns each record as-is, without translation. No delimiters are added between records.

- `--migrated-recall` | `--mr` (string)

  - The method by which migrated data set is handled. By default, a migrated data set is recalled synchronously. You can specify the following values: wait, nowait, error

    Default value: nowait

- `--record` | `-r` (boolean)

  - Data content in record mode, which means that no data conversion is performed and the record length is prepended to the data. The data transfer process returns each line as-is, without translation. No delimiters are added between records. Conflicts with binary.

- `--volume-serial` | `--vs` (string)

  - The volume serial (VOLSER) where the data set resides. You can use this option at any time. However, the VOLSER is required only when the data set is not cataloged on the system. A VOLSER is analogous to a drive name on a PC.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Stream content from stdin to a sequential data set named "ibmuser.ps" from a Windows console:

  - `echo "hello world" | zowe zos-files upload stdin-to-data-set "ibmuser.ps"`

- Stream content from stdin to a partition data set member named "ibmuser.pds(mem)" from a Windows console:

  - `echo "hello world" | zowe zos-files upload stdin-to-data-set "ibmuser.pds(mem)"`

- Stream content from stdin to a migrated data set and wait for it to be recalled from a Windows console:

  - `echo "hello world" | zowe zos-files upload stdin-to-data-set "ibmuser.ps" --migrated-recall wait`

## zowe › zos-files › view

View the contents of a data set or USS file on your terminal (stdout).

### zowe › zos-files › view › data-set

View content from a z/OS data set on your terminal (stdout).

#### Usage

zowe zos-files view data-set <dataSetName> [options]

#### Positional Arguments

- `dataSetName` (string)

  - The name of the data set you want to display.

#### Options

- `--binary` | `-b` (boolean)

  - Transfer the file content in binary mode (no EBCDIC to ASCII conversion).

- `--encoding` | `--ec` (string)

  - Transfer the file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--record` | `-r` (boolean)

  - Transfer the file content in record mode, which means that no data conversion is performed and the record length is prepended to the data. The data transfer process returns each line as-is, without translation. No delimiters are added between records. Conflicts with binary.

- `--volume-serial` | `--vs` (string)

  - The volume serial (VOLSER) where the data set resides. You can use this option at any time. However, the VOLSER is required only when the data set is not cataloged on the system. A VOLSER is analogous to a drive name on a PC.

- `--range` | `-R` (string)

  - The range of records to return in either `SSS-EEE` or `SSS,NNN` format. SSS identifies the start record, EEE identifies the end record, and NNN identifies the number of retrieved records.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- View the contents of the data set member "ibmuser.cntl(iefbr14)":

  - `zowe zos-files view data-set "ibmuser.cntl(iefbr14)"`

- View the contents of the data set member "ibmuser.test.loadlib(main)" in binary mode:

  - `zowe zos-files view data-set "ibmuser.test.loadlib(main)" --binary`

- View only the first two lines of content for data set member "ibmuser.cntl(iefbr14)":

  - `zowe zos-files view data-set "ibmuser.cntl(iefbr14)" --range 0,2`

- View only lines six through eight (zero-based) in the contents of the data set member "ibmuser.cntl(iefbr14)":

  - `zowe zos-files view data-set "ibmuser.cntl(iefbr14)" --range 5-7`

### zowe › zos-files › view › uss-file

View content from a Unix System Services (USS) file on your terminal (stdout).

#### Usage

zowe zos-files view uss-file <file> [options]

#### Positional Arguments

- `file` (string)

  - The name of the USS file you want to display.

#### Options

- `--binary` | `-b` (boolean)

  - Transfer the file content in binary mode (no EBCDIC to ASCII conversion).

- `--encoding` | `--ec` (string)

  - Transfer the file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--range` | `-R` (string)

  - The range of records to return in either `SSS-EEE` or `SSS,NNN` format. SSS identifies the start record, EEE identifies the end record, and NNN identifies the number of retrieved records.

- `--response-timeout` | `--rto` (number)

  - The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- View the contents of the USS file "/a/ibmuser/my_text.txt":

  - `zowe zos-files view uss-file "/a/ibmuser/my_text.txt"`

- View the contents of the USS file "/a/ibmuser/MyJavaClass.class" in binary mode:

  - `zowe zos-files view uss-file "/a/ibmuser/MyJavaClass.class" --binary`

## zowe › zos-ftp

Data set and job functionality via FTP. This functionality uses the open source zos-node-accessor package from IBM. Commands under this group require you to create a zftp profile before using them.
If you find this functionality useful, please consider setting up z/OSMF on your system to get improved stability and speed and more features (for example, issuing TSO and console commands) by using core Zowe CLI.

## zowe › zos-ftp › allocate

Allocate a sequential or partitioned dataset

### zowe › zos-ftp › allocate › data-set

Allocate a sequential dataset or partitioned dataset with '--dcb "PDSTYPE=PDS"'

#### Usage

zowe zos-ftp allocate data-set <datasetName> [options]

#### Positional Arguments

- `datasetName` (string)

  - The dataset name you'd like to allocate.

#### Options

- `--dcb` (string)

  - DCB parameters for dataset allocation. It's space separated like "RECFM=FB LRECL=326 BLKSIZE=23472". For the list of possible DCB parameters, visit https://github.com/IBM/zos-node-accessor/tree/1.0.x#allocate.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Allocate a sequential dataset "IBMUSER.DATASET":

  - `zowe zos-ftp allocate data-set "IBMUSER.DATASET"`

- Allocate a partitioned dataset "IBMUSER.DATASET":

  - `zowe zos-ftp allocate data-set "IBMUSER.DATASET" --dcb "PDSTYPE=PDS"`

## zowe › zos-ftp › delete

Delete data sets, jobs, and USS files

### zowe › zos-ftp › delete › data-set

Delete a data set

#### Usage

zowe zos-ftp delete data-set <dataSet> [options]

#### Positional Arguments

- `dataSet` (string)

  - The data set (PDS member or physical sequential data set) which you would like to delete.

#### Required Options

- `--for-sure` | `-f` (boolean)

  - Specify this option to confirm that you want to delete the data set permanently.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Delete the data set "ibmuser.cntl":

  - `zowe zos-ftp delete data-set "ibmuser.cntl" -f`

### zowe › zos-ftp › delete › job

Cancel a job and purge its output. Note: this command will not work to delete TSU or STC type jobs.

#### Usage

zowe zos-ftp delete job <jobid> [options]

#### Positional Arguments

- `jobid` (string)

  - The ID of the job that you would like to delete

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Cancel the job "JOB00123" and purge its output, optionally abbreviating the job ID:

  - `zowe zos-ftp delete job j123`

### zowe › zos-ftp › delete › uss-file

Delete a USS file

#### Usage

zowe zos-ftp delete uss-file <ussFile> [options]

#### Positional Arguments

- `ussFile` (string)

  - The absolute path to a USS file you would like to delete.

#### Required Options

- `--for-sure` | `-f` (boolean)

  - Specify this option to confirm that you want to delete the data set permanently.

#### Options

- `--recursive` (boolean)

  - Delete the directory and all files/directories under it.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Delete the USS file "/u/ibmuser/myfile.txt":

  - `zowe zos-ftp delete uss-file "/u/ibmuser/myfile.txt" -f`

## zowe › zos-ftp › download

Download data set, job spool, and USS file content

### zowe › zos-ftp › download › all-spool-by-jobid

Download all spool content for a job to files in a local directory by providing the job id

#### Usage

zowe zos-ftp download all-spool-by-jobid <jobid> [options]

#### Positional Arguments

- `jobid` (string)

  - The ID of the job for which you would like to list spool files

#### Options

- `--directory` | `-d` (string)

  - The local directory to save the spool content to. By default, it will be saved to "./output".

- `--omit-jobid-directory` | `--ojd` (boolean)

  - If you specify this, the job output will be saved directly to the specified (or default) directory. For example, if you omit this, the output would be saved to ./output/JOB00123. If you specify --ojd, the JOB00123 directory would not be included in the output path and the content would be saved to ./output.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Download all spool for the job with the ID JOB00123 to the default subdirectory in the current directory:

  - `zowe zos-ftp download all-spool-by-jobid j123`

- Download all spool for the job with the ID JOB00123 to the directory build/job_output:

  - `zowe zos-ftp download all-spool-by-jobid j123 -d build/job_output/`

### zowe › zos-ftp › download › data-set

Download the contents of a z/OS data set to a local file

#### Usage

zowe zos-ftp download data-set <dataSet> [options]

#### Positional Arguments

- `dataSet` (string)

  - The data set (PDS member or physical sequential data set) which you would like to download to a local file.

#### Options

- `--binary` | `-b` (boolean)

  - Download the file content in binary mode, which means that no data conversion is performed. The data transfer process returns each line as-is, without translation. No delimiters are added between records.

- `--file` | `-f` (string)

  - The path to the local file where you want to download the content. When you omit the option, the command generates a file name automatically for you.

- `--record` | `-r` | `--rdw` (boolean)

  - Download the variable-length data set with RECFM of V, VB, VBS, etc in rdw mode, in which the 4-byte RDW (Record Descriptor Word) is inserted at the begining of each record.

- `--encoding` | `--ec` (string)

  - The encoding for download and upload of z/OS data set.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Download the data set "ibmuser.loadlib(main)" in binary mode to the local file "main.obj":

  - `zowe zos-ftp download data-set "ibmuser.loadlib(main)" -b -f main.obj`

### zowe › zos-ftp › download › uss-file

Download the contents of a USS file to a local file

#### Usage

zowe zos-ftp download uss-file <ussFile> [options]

#### Positional Arguments

- `ussFile` (string)

  - The path to the USS file you would like to download.

#### Options

- `--binary` | `-b` (boolean)

  - Download the file content in binary mode, which means that no data conversion is performed. The data transfer process returns each line as-is, without translation. No delimiters are added between records.

- `--file` | `-f` (string)

  - The path to the local file where you want to download the content. When you omit the option, the command generates a file name automatically for you.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Download the USS file "/u/users/ibmuser/main.obj" in binary mode to the local file "main.obj":

  - `zowe zos-ftp download uss-file "/u/users/ibmuser/main.obj" -b -f main.obj`

## zowe › zos-ftp › list

List data sets, data set members, uss files, jobs, spool files

### zowe › zos-ftp › list › data-set

List all data sets that match a DSLEVEL pattern (see help below).
The following values can be used with the --response-format-filter (--rff) argument to display more data from the data sets:volume, unit, referred, ext, used, recfm, lrecl, blksz, dsorg, and dsname.

#### Usage

zowe zos-ftp list data-set <pattern> [options]

#### Positional Arguments

- `pattern` (string)

  - The pattern or patterns to match data sets against. Also known as 'DSLEVEL', it is somewhat similar to the concept of a 'glob' (but not identical). The following special sequences can be used in the pattern:
    %: Matches any single character
    *: Matches any number of characters within a data set name qualifier (e.g. "ibmuser.j*.old" matches "ibmuser.jcl.old" but not "ibmuser.jcl.very.old")
    **: Matches any number of characters within any number of data set name qualifiers (e.g. "ibmuser.**.old" matches both "ibmuser.jcl.old" and "ibmuser.jcl.very.old")
    However, the pattern cannot begin with any of these sequences.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List all data sets beginning with "ibmuser" and ending in "cntl":

  - `zowe zos-ftp list data-set "ibmuser.**.cntl"`

### zowe › zos-ftp › list › data-set-members

List all members of the specified PDS or PDSE data set.

#### Usage

zowe zos-ftp list data-set-members <dsname> [options]

#### Positional Arguments

- `dsname` (string)

  - The PDS or PDSE data set name.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List all members in data set "ibmuser.test.cntl":

  - `zowe zos-ftp list data-set-members "ibmuser.test.cntl"`

### zowe › zos-ftp › list › jobs

List all data sets that match a DSLEVEL pattern (see help below).

#### Usage

zowe zos-ftp list jobs [options]

#### Options

- `--prefix` (string)

  - Specify the job name prefix of the jobs you own and want to list. You can specify a wildcard, which is usually in the form "JOB*".
    If you don't specify this option all jobs under this owner will be listed by default.

- `--owner` | `-o` (string)

  - Specify the owner user ID of the jobs you want to list. The owner is the individual/user who submitted the job OR the user ID assigned to the job.

- `--status` | `-s` (string)

  - Specify the status of the jobs you want to list. The status is one of the following: INPUT, ACTIVE and OUTPUT.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List all jobs with names beginning beginning with "ibmu":

  - `zowe zos-ftp list jobs --prefix "ibmu*"`

- List Alice's jobs with names beginning beginning with "ibmu":

  - `zowe zos-ftp list jobs --prefix "ibmu*" --owner "alice"`

### zowe › zos-ftp › list › spool-files-by-jobid

Given a z/OS job JOBID, list the spool files (DDs) for a z/OS job on the JES/spool queues. The command does not pre-validate the JOBID.

#### Usage

zowe zos-ftp list spool-files-by-jobid <jobId> [options]

#### Positional Arguments

- `jobId` (string)

  - The z/OS JOBID of the job with the spool files you want to list. No pre-validation of the JOBID is performed.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List the spool files of the job with JOBID JOB00123:

  - `zowe zos-ftp list spool-files-by-jobid job00123`

### zowe › zos-ftp › list › uss-files

List USS files and subdirectories in a directory. Optional file name pattern like "prefix*", "*suffix", or "prefix*suffix" can be specified at the end of directory. See EXAMPLES section.

The following values can be used with the --response-format-filter (--rff) argument to display more data from the data sets: name, size, owner, group, and permissions.

#### Usage

zowe zos-ftp list uss-files <directory> [options]

#### Positional Arguments

- `directory` (string)

  - The USS directory to list files in, or the directory with file name pattern

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List USS files in the directory "/u/users/ibmuser/":

  - `zowe zos-ftp list uss-files "/u/users/ibmuser"`

- List USS files with suffix of ".txt" in the directory "/u/users/ibmuser/":

  - `zowe zos-ftp list uss-files "/u/users/ibmuser/*.txt"`

- List USS files in the directory "/u/users/ibmuser/" and show only the file name:

  - `zowe zos-ftp list uss-files "/u/users/ibmuser/" --rff name`

## zowe › zos-ftp › make

Make a USS directory

### zowe › zos-ftp › make › uss-directory

Make a Unix System Services Directory

#### Usage

zowe zos-ftp make uss-directory <ussDirectory> [options]

#### Positional Arguments

- `ussDirectory` (string)

  - The USS directory you'd like to make.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Make a USS directory "/u/users/ibmuser/mydir":

  - `zowe zos-ftp make uss-directory "/u/users/ibmuser/mydir"`

## zowe › zos-ftp › rename

Rename data sets and USS files or directories

### zowe › zos-ftp › rename › data-set

Rename a cataloged data set

#### Usage

zowe zos-ftp rename data-set <oldDataSet> <newDataSet> [options]

#### Positional Arguments

- `oldDataSet` (string)

  - The current name of the data set you want to rename.

- `newDataSet` (string)

  - The new name for the data set.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Rename the data set ibmuser.jcl to ibmuser.cntl:

  - `zowe zos-ftp rename data-set ibmuser.jcl ibmuser.cntl`

- Rename the data set member "ibmuser.cntl(alloc)" to "ibmuser.cntl(alloc2)". Note: you can only rename members within the same partitioned data set. You cannot move a member to another data set with this command.:

  - `zowe zos-ftp rename data-set "ibmuser.cntl(alloc)" "ibmuser.cntl(alloc2)"`

### zowe › zos-ftp › rename › uss-file

Rename a USS file or directory

#### Usage

zowe zos-ftp rename uss-file <olduss> <newuss> [options]

#### Positional Arguments

- `olduss` (string)

  - The current name of the USS file you want to rename.

- `newuss` (string)

  - The new name for the USS file.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Rename the file /u/users/ibmuser/hello.txt to /u/users/ibmuser/hello2.txt:

  - `zowe zos-ftp rename uss-file "/u/users/ibmuser/hello.txt" "/u/users/ibmuser/hello2.txt"`

## zowe › zos-ftp › submit

Submit jobs from local files and data sets

### zowe › zos-ftp › submit › data-set

Submit a job from a cataloged data set containing JCL. The JCL will be downloaded via FTP and then submitted.

#### Usage

zowe zos-ftp submit data-set <dataSet> [options]

#### Positional Arguments

- `dataSet` (string)

  - The data set containing JCL that you would like to submit

#### Options

- `--wait` | `-w` (string)

  - Specify job query interval and max times of querying job status. The format of this option is comma-separated numeric values. For example, '5,12' means queries job status every 5 seconds for 12 times at most.

- `--wait-for-output` | `--wfo` (boolean)

  - Wait for the job to enter OUTPUT status before completing the command.

- `--wait-for-active` | `--wfa` (boolean)

  - Wait for the job to enter ACTIVE status before completing the command.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Submit a job residing in the data set "ibmuser.cntl(iefbr14)":

  - `zowe zos-ftp submit data-set "ibmuser.cntl(iefbr14)"`

- Submit a job from the data set "ibmuser.cntl(iefbr14)" and print only the job ID:

  - `zowe zos-ftp submit data-set "ibmuser.cntl(iefbr14)" --rff jobid --rft string`

- Submit a job from the data set "ibmuser.cntl(iefbr14)" and wait for job complete.:

  - `zowe zos-ftp submit data-set "ibmuser.cntl(iefbr14)" --wait 5,12`

### zowe › zos-ftp › submit › local-file

Submit a job from a local file containing JCL

#### Usage

zowe zos-ftp submit local-file <file> [options]

#### Positional Arguments

- `file` (local file path)

  - The file you would like to submit as jcl

#### Options

- `--wait` | `-w` (string)

  - Specify job query interval and max times of querying job status. The format of this option is comma-separated numeric values. For example, '5,12' means queries job status every 5 seconds for 12 times at most.

- `--wait-for-output` | `--wfo` (boolean)

  - Wait for the job to enter OUTPUT status before completing the command.

- `--wait-for-active` | `--wfa` (boolean)

  - Wait for the job to enter ACTIVE status before completing the command.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Submit a job from the local file "my_build_jcl.txt":

  - `zowe zos-ftp submit local-file "my_build_jcl.txt"`

- Submit a job from the local file "my_build_jcl.txt" and print only the job ID:

  - `zowe zos-ftp submit local-file "my_build_jcl.txt" --rff jobid --rft string`

- Submit a job from the local file "my_build_jcl.txt" and wait for job complete.:

  - `zowe zos-ftp submit local-file "my_build_jcl.txt" --wait 5,12`

### zowe › zos-ftp › submit › stdin

Submit a job from JCL written to the standard input (stdin) of this process.

#### Usage

zowe zos-ftp submit stdin [options]

#### Options

- `--wait` | `-w` (string)

  - Specify job query interval and max times of querying job status. The format of this option is comma-separated numeric values. For example, '5,12' means queries job status every 5 seconds for 12 times at most.

- `--wait-for-output` | `--wfo` (boolean)

  - Wait for the job to enter OUTPUT status before completing the command.

- `--wait-for-active` | `--wfa` (boolean)

  - Wait for the job to enter ACTIVE status before completing the command.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Submit a job from stdin, redirecting the contents of my_jcl.txt in.:

  - `zowe zos-ftp submit stdin < my_jcl.txt`

- Submit a job from the local file "my_build_jcl.txt" and wait for job complete.:

  - `zowe zos-ftp submit stdin "my_build_jcl.txt" --wait 5,12`

## zowe › zos-ftp › upload

Upload data set and USS content

### zowe › zos-ftp › upload › file-to-data-set

Upload contents of a local file to a z/OS data set

#### Usage

zowe zos-ftp upload file-to-data-set <file> <dataSet> [options]

#### Positional Arguments

- `file` (local file path)

  - Upload the contents of this file to the data set

- `dataSet` (string)

  - The data set (PDS member or physical sequential data set) to which you would like to upload content.

#### Options

- `--binary` | `-b` (boolean)

  - Upload content in binary mode.

- `--dcb` (string)

  - DCB parameters for sequential dataset (PS dataset) allocation if not existing. It is space separated like RECFM=FB LRECL=326 BLKSIZE=23472

- `--encoding` | `--ec` (string)

  - The encoding for download and upload of z/OS data set.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Upload to "ibmuser.cntl(iefbr14)" from the file iefbr14.txt:

  - `zowe zos-ftp upload file-to-data-set iefbr14.txt "ibmuser.cntl(iefbr14)"`

- Upload to "ibmuser.dataset" from the file dataset.txt with the DCB parameters:

  - `zowe zos-ftp upload file-to-data-set dataset.txt "ibmuser.dataset" --dcb "RECFM=FB LRECL=326 BLKSIZE=23472"`

### zowe › zos-ftp › upload › file-to-uss-file

Upload contents of a local to a Unix System Services file.

#### Usage

zowe zos-ftp upload file-to-uss-file <file> <ussFile> [options]

#### Positional Arguments

- `file` (local file path)

  - Upload the contents of this local file to a data set.

- `ussFile` (string)

  - The USS file to which you would like to upload content.

#### Options

- `--binary` | `-b` (boolean)

  - Upload content in binary mode.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Upload to "/u/users/ibmuser/iefbr14.txt" from the file iefbr14.txt:

  - `zowe zos-ftp upload file-to-uss-file iefbr14.txt "/u/users/ibmuser/iefbr14.txt"`

### zowe › zos-ftp › upload › stdin-to-data-set

Upload contents piped to stdin to a z/OS data set

#### Usage

zowe zos-ftp upload stdin-to-data-set <dataSet> [options]

#### Positional Arguments

- `dataSet` (string)

  - The data set (PDS member or physical sequential data set) to which you would like to upload content.

#### Options

- `--binary` | `-b` (boolean)

  - Upload content in binary mode.

- `--encoding` | `--ec` (string)

  - The encoding for download and upload of z/OS data set.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Upload to "ibmuser.cntl(iefbr14)" from standard input (you can pipe into this command):

  - `zowe zos-ftp upload stdin-to-data-set "ibmuser.cntl(iefbr14)"`

### zowe › zos-ftp › upload › stdin-to-uss-file

Upload from stdin to a Unix System Services File

#### Usage

zowe zos-ftp upload stdin-to-uss-file <ussFile> [options]

#### Positional Arguments

- `ussFile` (string)

  - The USS file to which you would like to upload content.

#### Options

- `--binary` | `-b` (boolean)

  - Upload content in binary mode.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- Upload to "/u/users/ibmuser/iefbr14.txt" from standard input (you can pipe into this command):

  - `zowe zos-ftp upload stdin-to-uss-file "/u/users/ibmuser/iefbr14.txt"`

## zowe › zos-ftp › view

View data sets, job output, and USS content

### zowe › zos-ftp › view › all-spool-by-jobid

View all spool content for a job by providing the job id

#### Usage

zowe zos-ftp view all-spool-by-jobid <jobid> [options]

#### Positional Arguments

- `jobid` (string)

  - The ID of the job for which you would like to list spool files

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- View all spool content for the job with ID JOB00123 (optionally abbreviating the job ID):

  - `zowe zos-ftp view all-spool-by-jobid j123`

### zowe › zos-ftp › view › data-set

View the contents of a z/OS data set

#### Usage

zowe zos-ftp view data-set <dataSet> [options]

#### Positional Arguments

- `dataSet` (string)

  - The data set (PDS member or physical sequential data set) which you would like to view the contents of.

#### Options

- `--binary` | `-b` (boolean)

  - View content in binary form without converting to ASCII text

- `--encoding` | `--ec` (string)

  - The encoding for download and upload of z/OS data set.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- View the content of the data set "ibmuser.cntl(iefbr14)":

  - `zowe zos-ftp view data-set "ibmuser.cntl(iefbr14)"`

- View the content of the data set "ibmuser.loadlib(main)" and pipe it into the hex viewer program xxd:

  - `zowe zos-ftp view data-set "ibmuser.loadlib(main)" -b | xxd`

### zowe › zos-ftp › view › job-status-by-jobid

View status details of a single z/OS job on spool/JES queues. The command does not prevalidate the JOBID.

#### Usage

zowe zos-ftp view job-status-by-jobid <jobId> [options]

#### Positional Arguments

- `jobId` (string)

  - The ID of the jobfor which you would like to list spool files

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- View the status for the job with ID "JOB00123" (optionally abbreviating the ID):

  - `zowe zos-ftp view job-status-by-jobid j123`

### zowe › zos-ftp › view › spool-file-by-id

View the contents of a spool file from a z/OS job on spool/JES queues. The command does not pre-validate the JOBID or spool ID.

#### Usage

zowe zos-ftp view spool-file-by-id <jobid> <spoolfileid> [options]

#### Positional Arguments

- `jobid` (string)

  - The z/OS JOBID of the job containing the spool file you want to view. No pre-validation of the JOBID is performed.

- `spoolfileid` (number)

  - The spool file ID number for the spool file to view. No pre-validation of the ID is performed.

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- View the spool file with ID 4 for the job with job ID JOB00123:

  - `zowe zos-ftp view spool-file-by-id JOB00123 4`

### zowe › zos-ftp › view › uss-file

View the contents of a Unix System Services File

#### Usage

zowe zos-ftp view uss-file <ussFile> [options]

#### Positional Arguments

- `ussFile` (string)

  - The USS file you'd like to view the contents of.

#### Options

- `--binary` | `-b` (boolean)

  - View content in binary form without converting to ASCII text

#### FTP Connection options

- `--host` | `-H` (string)

  - The hostname or IP address of the z/OS server to connect to.

- `--port` | `-P` (number)

  - The port of the z/OS FTP server.

    Default value: 21

- `--user` | `-u` (string)

  - Username for authentication on z/OS

- `--password` | `-p` | `--pass` | `--pw` (string)

  - Password to authenticate to FTP.

- `--secure-ftp` (boolean)

  - Set to true for both control and data connection encryption, 'control' for control connection encryption only, or 'implicit' for implicitly encrypted control connection (this mode is deprecated in modern times, but usually uses port 990). Note: Unfortunately, this plugin's functionality only works with FTP and FTPS, not 'SFTP' which is FTP over SSH.

    Default value: true

- `--connection-timeout` | `--ct` (number)

  - How long (in milliseconds) to wait for the control connection to be established.

    Default value: 10000

#### TLS / Secure Connection options

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates. Only specify this if you are connecting to a secure FTP instance.

- `--server-name` | `--sn` (string)

  - Server name for the SNI (Server Name Indication) TLS extension. Only specify if you are connecting securely

#### Profile Options

- `--zftp-profile` | `--zftp-p` (string)

  - The name of a (zftp) 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

- `--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

- View the content of the USS file "/u/users/ibmuser/myfile.txt":

  - `zowe zos-ftp view uss-file "/u/users/ibmuser/myfile.txt"`

- View the content of the USS file "/u/users/ibmuser/myjava.jar" in binary mode and pipe it into the hex viewer command xxd:

  - `zowe zos-ftp view uss-file "/u/users/ibmuser/myjava.jar" -b | xxd`

## zowe › zos-jobs

Manage z/OS jobs.

## zowe › zos-jobs › cancel

Cancel a single job by job ID. This cancels the job if it is running or on input.

### zowe › zos-jobs › cancel › job

Cancel a single job by job ID.

#### Usage

zowe zos-jobs cancel job <jobid> [options]

#### Positional Arguments

- `jobid` (string)

  - The job ID (e.g. JOB00123) of the job. Job ID is a unique identifier for z/OS batch jobs -- no two jobs on one system can have the same ID. Note: z/OS allows you to abbreviate the job ID if desired. You can use, for example "J123".

#### Options

- `--modify-version` (string)

  - Using this option to set X-IBM-Job-Modify-Version to "1.0" will make the delete job API asynchronous. Otherwise, it will be synchronous by default.

    Default value: 2.0

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Cancel job with job ID JOB03456:

  - `zowe zos-jobs cancel job JOB03456`

- Cancel job with job ID JOB03456 synchronously:

  - `zowe zos-jobs cancel job JOB03456 --modify-version "2.0"`

## zowe › zos-jobs › delete

Delete a single job by job ID or delete multiple jobs in OUTPUT status.

### zowe › zos-jobs › delete › job

Delete a single job by job ID.

#### Usage

zowe zos-jobs delete job <jobid> [options]

#### Positional Arguments

- `jobid` (string)

  - The job ID (e.g. JOB00123) of the job. Job ID is a unique identifier for z/OS batch jobs -- no two jobs on one system can have the same ID. Note: z/OS allows you to abbreviate the job ID if desired. You can use, for example "J123".

#### Options

- `--modify-version` (string)

  - Using this option to set X-IBM-Job-Modify-Version to "1.0" will make the delete job API asynchronous. Otherwise, it will be synchronous by default.

    Default value: 2.0

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Delete job with job ID JOB03456:

  - `zowe zos-jobs delete job JOB03456`

- Delete job with job ID JOB03456 synchronously:

  - `zowe zos-jobs delete job JOB03456 --modify-version "2.0"`

### zowe › zos-jobs › delete › old-jobs

Delete (purge) jobs in OUTPUT status. Defaults to deleting all jobs owned by your user ID that are in output status.

#### Usage

zowe zos-jobs delete old-jobs [options]

#### Options

- `--prefix` | `-p` (string)

  - Only delete jobs with job names that match this prefix. Defaults to deleting all jobs owned by your user ID that are in output status.

- `--max-concurrent-requests` | `--mcr` (number)

  - Specifies the maximum number of concurrent z/OSMF REST API requests to delete jobs. Increasing the value makes the command run faster. However, increasing the value increases resource consumption on z/OS and can be prone to errors caused by making too many concurrent requests. When you specify 0, Zowe CLI attempts to delete all jobs at once without a maximum number of concurrent requests.

    Default value: 1

- `--modify-version` (string)

  - Using this option to set X-IBM-Job-Modify-Version to "1.0" will make the delete job API asynchronous. Otherwise, it will be synchronous by default.

    Default value: 2.0

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Delete all of your jobs in output status with a job name starting with "ibmuser":

  - `zowe zos-jobs delete old-jobs --prefix "ibmuser*"`

## zowe › zos-jobs › download

Download the output of a job as separate files.

### zowe › zos-jobs › download › output

Download all job output to a local directory. Each spool DD will be downloaded to its own file in the directory.

#### Usage

zowe zos-jobs download output <jobid> [options]

#### Positional Arguments

- `jobid` (string)

  - The z/OS JOBID of the job containing the spool files you want to view. No pre-validation of the JOBID is performed.

#### Options

- `--directory` | `-d` | `--dir` (string)

  - The local directory you would like to download the output for the job to.

- `--extension` | `-e` (string)

  - A file extension to save the job output with. Defaults to '.txt'.

- `--omit-jobid-directory` | `--ojd` (boolean)

  - If specified, job output will be saved directly to the specified directory rather than creating a subdirectory named after the ID of the job.

- `--binary` | `-b` (boolean)

  - If specified, job output will be downloaded in binary format instead of performing text conversion. Conflicts with record.

- `--record` | `-r` (boolean)

  - If specified, job output will be downloaded in record format instead of performing text conversion. Conflicts with binary.

- `--encoding` | `--ec` (string)

  - Download the spool file content with encoding mode, which means that data conversion is performed using the file encoding specified.

- `--wait-for-active` | `--wfa` (boolean)

  - Wait for the job to enter ACTIVE status before completing the command.

- `--wait-for-output` | `--wfo` (boolean)

  - Wait for the job to enter OUTPUT status before completing the command.

- `--record-range` | `--rr` (string)

  - Zero indexed range of records to download from a spool file. (example: 0-100)

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Download all the output of the job with job ID JOB00234 to an automatically generated directory.:

  - `zowe zos-jobs download output JOB00234`

- Download the records in the range of 0 to 100 from a job spool.:

  - `zowe zos-jobs download output --record-range '0-100'`

## zowe › zos-jobs › list

List z/OS jobs and list the spool files (DDs) for a z/OS job on the JES/spool queues.

### zowe › zos-jobs › list › jobs

List jobs on JES spool/queues. By default, the command lists jobs owned (owner) by the user specified in your z/OSMF profile. The default for prefix is "*". The command does not prevalidate your user ID. The command surfaces errors verbatim from the z/OSMF Jobs REST endpoints.

#### Usage

zowe zos-jobs list jobs [options]

#### Options

- `--owner` | `-o` (string)

  - Specify the owner of the jobs you want to list. The owner is the individual/user who submitted the job OR the user ID assigned to the job. The command does not prevalidate the owner. You can specify a wildcard according to the z/OSMF Jobs REST endpoint documentation, which is usually in the form "USER*".

- `--prefix` | `-p` (string)

  - Specify the job name prefix of the jobs you want to list. The command does not prevalidate the owner. You can specify a wildcard according to the z/OSMF Jobs REST endpoint documentation, which is usually in the form "JOB*".

- `--exec-data` | `--ed` (boolean)

  - Use this option to retrieve execution data for jobs via the z/OSMF REST API.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List all jobs with default settings. The command returns jobs owned by your user ID with any job name:

  - `zowe zos-jobs list jobs`

- List all jobs owned by user IDs starting with 'ibmu' and job names starting with 'myjo':

  - `zowe zos-jobs list jobs --owner "ibmu*" --prefix "myjo*"`

- List all jobs with default owner and prefix settings, displaying only the job ID of each job:

  - `zowe zos-jobs list jobs --response-format-filter jobid --response-format-type table`

- List all jobs and return job execution data along with the default information:

  - `zowe zos-jobs list jobs --exec-data`

- List all jobs owned by user IDs starting with 'ibmu' and return job execution data along with the default information:

  - `zowe zos-jobs list jobs --owner "ibmu*" --exec-data`

- List all jobs owned by user IDs starting with 'ibmu' and job names starting with 'myjo' and return job execution data along with the default information:

  - `zowe zos-jobs list jobs --owner "ibmu*" --prefix "myjo*" --exec-data`

### zowe › zos-jobs › list › spool-files-by-jobid

Given a z/OS job JOBID, list the spool files (DDs) for a z/OS job on the JES/spool queues. The command does not pre-validate the JOBID. The command presents errors verbatim from the z/OSMF Jobs REST endpoints.

#### Usage

zowe zos-jobs list spool-files-by-jobid <jobid> [options]

#### Positional Arguments

- `jobid` (string)

  - The z/OS JOBID of the job with the spool files you want to list. No pre-validation of the JOBID is performed.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List the spool files of the job with JOBID JOB00123:

  - `zowe zos-jobs list spool-files-by-jobid job00123`

## zowe › zos-jobs › modify

Modify the job class or the hold status of a job.

### zowe › zos-jobs › modify › job

Modify the job class or the hold status of a job.

#### Usage

zowe zos-jobs modify job <jobid> [options]

#### Positional Arguments

- `jobid` (string)

  - The job ID (e.g. JOB00123) of the job. Job ID is a unique identifier for z/OS batch jobs -- no two jobs on one system can have the same ID. Note: z/OS allows you to abbreviate the job ID if desired. You can use, for example "J123".

#### Options

- `--jobclass` (string)

  - The job class (e.g. 'A', 'B', ...) assigned to the job.

- `--hold` (boolean)

  - Setting this flag will prevent a job from executing until entering a second command with the '--release' flag

- `--release` (boolean)

  - Flag that releases a held a job for execution

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Modify class of job with job ID JOB0000:

  - `zowe zos-jobs modify job JOB0000 --jobclass A`

- Hold job with job ID JOB0000:

  - `zowe zos-jobs modify job JOB0000 --hold`

- Release job with job ID JOB0000:

  - `zowe zos-jobs modify job JOB0000 --release`

## zowe › zos-jobs › search

Search the spool output of a job.

### zowe › zos-jobs › search › job

Search the spool output of a job.

#### Usage

zowe zos-jobs search job <jobname> [options]

#### Positional Arguments

- `jobname` (string)

  - The job name to search. Wildcards are accepted for the job name. You can use, for example "USERJOB*" to search all jobs that start with USERJOB.

#### Options

- `--search-string` | `--string` (string)

  - The string to search for in the spool output.

- `--search-regex` | `--regex` (string)

  - The regular expression to search for in the spool output.

- `--case-insensitive` | `--ci` (boolean)

  - The search is case insensitive or not.

    Default value: true

- `--search-limit` | `--sl` (number)

  - The maximum number of matching lines to return for an individual spool file.

    Default value: 100

- `--file-limit` | `--fl` (number)

  - The maximum number of spool files to search.

    Default value: 100

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Search all jobs named USERJOB for the string "RC=0000":

  - `zowe zos-jobs search job "USERJOB" --search-string "RC=0000"`

- Search all jobs that start with USER for the string "ENDED":

  - `zowe zos-jobs search job "USER*" --search-string "ENDED"`

- Search all jobs named USERJOB for the string "COND CODE", with the options case sensitive and a search limit of 5:

  - `zowe zos-jobs search job "USERJOB" --search-string "COND CODE" --case-insensitive false --search-limit 5`

## zowe › zos-jobs › submit

Submit a job (JCL).

### zowe › zos-jobs › submit › data-set

Submit a job (JCL) contained in a data set. The data set may be of type physical sequential or a PDS member. The command does not pre-validate the data set name. The command presents errors verbatim from the z/OSMF Jobs REST endpoints. For more information about z/OSMF Jobs API errors, see the z/OSMF Jobs API REST documentation.

#### Usage

zowe zos-jobs submit data-set <dataset> [options]

#### Positional Arguments

- `dataset` (string)

  - The z/OS data set containing the JCL to submit. You can specify a physical sequential data set (for example, "DATA.SET") or a partitioned data set qualified by a member (for example, "DATA.SET(MEMBER)").

#### Options

- `--volume` | `--vol` (string)

  - The volume serial (VOLSER) where the data set resides. The option is required only when the data set is not catalogued on the system.

- `--wait-for-active` | `--wfa` (boolean)

  - Wait for the job to enter ACTIVE status before completing the command.

- `--wait-for-output` | `--wfo` (boolean)

  - Wait for the job to enter OUTPUT status before completing the command.

- `--view-all-spool-content` | `--vasc` (boolean)

  - Print all spool output. If you use this option you will wait for the job to complete.

- `--directory` | `-d` (string)

  - The local directory you would like to download the output of the job. Creates a subdirectory using the jobID as the name and files are titled based on DD names. If you use this option you will wait for the job to complete.

- `--extension` | `-e` (string)

  - A file extension to save the job output with. Default is '.txt'.

- `--jcl-symbols` | `--js` (string)

  - A string of JCL symbols to use for substitution. For symbol values with no spaces: "symbol1=value1 symbol2=value2 ...". When a value contains spaces, enclose the value in single quotes: "symbol1='value 1 with spaces' symbol2='value 2 with spaces' ...". To embed a single quote in a value, use two single quotes: "NAME=O''Brian".

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Submit the JCL in the data set "ibmuser.cntl(deploy)":

  - `zowe zos-jobs submit data-set "ibmuser.cntl(deploy)"`

- Submit the JCL in the data set "ibmuser.cntl(deploy)", wait for the job to complete and print all output from the job:

  - `zowe zos-jobs submit data-set "ibmuser.cntl(deploy)" --view-all-spool-content`

### zowe › zos-jobs › submit › local-file

Submit a job (JCL) contained in a local file. The command presents errors verbatim from the z/OSMF Jobs REST endpoints. For more information about z/OSMF Jobs API errors, see the z/OSMF Jobs API REST documentation.

#### Usage

zowe zos-jobs submit local-file <localFile> [options]

#### Positional Arguments

- `localFile` (string)

  - The local file containing the JCL to submit.

#### Options

- `--wait-for-active` | `--wfa` (boolean)

  - Wait for the job to enter ACTIVE status before completing the command.

- `--wait-for-output` | `--wfo` (boolean)

  - Wait for the job to enter OUTPUT status before completing the command.

- `--view-all-spool-content` | `--vasc` (boolean)

  - Print all spool output. If you use this option you will wait for the job to complete.

- `--directory` | `-d` (string)

  - The local directory you would like to download the output of the job. Creates a subdirectory using the jobID as the name and files are titled based on DD names. If you use this option you will wait for the job to complete.

- `--extension` | `-e` (string)

  - A file extension to save the job output with. Default is '.txt'.

- `--jcl-symbols` | `--js` (string)

  - A string of JCL symbols to use for substitution. For symbol values with no spaces: "symbol1=value1 symbol2=value2 ...". When a value contains spaces, enclose the value in single quotes: "symbol1='value 1 with spaces' symbol2='value 2 with spaces' ...". To embed a single quote in a value, use two single quotes: "NAME=O''Brian".

- `--job-encoding` | `--je` (string)

  - The encoding that should be used to read the JCL into the z/OSMF JCL reader. JCL will be converted into this codepage from UTF-8 for the JES subsystem to parse.

- `--job-record-length` | `--jrl` (number)

  - The logical record length of the JCL being submitted.

    Default value: 80

- `--job-record-format` | `--jrf` (string)

  - The record format of the JCL being submitted, where V is variable, and F is fixed.

    Default value: F
    Allowed values: F, V

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Submit the JCL in the file "iefbr14.txt":

  - `zowe zos-jobs submit local-file "iefbr14.txt"`

### zowe › zos-jobs › submit › stdin

Submit a job (JCL) passed to the command via the stdin stream. The command presents errors verbatim from the z/OSMF Jobs REST endpoints. For more information about z/OSMF Jobs API errors, see the z/OSMF Jobs API REST documentation.

#### Usage

zowe zos-jobs submit stdin [options]

#### Options

- `--wait-for-active` | `--wfa` (boolean)

  - Wait for the job to enter ACTIVE status before completing the command.

- `--wait-for-output` | `--wfo` (boolean)

  - Wait for the job to enter OUTPUT status before completing the command.

- `--view-all-spool-content` | `--vasc` (boolean)

  - Print all spool output. If you use this option you will wait for the job to complete.

- `--directory` | `-d` (string)

  - The local directory you would like to download the output of the job. Creates a subdirectory using the jobID as the name and files are titled based on DD names. If you use this option you will wait for the job to complete.

- `--extension` | `-e` (string)

  - A file extension to save the job output with. Default is '.txt'.

- `--jcl-symbols` | `--js` (string)

  - A string of JCL symbols to use for substitution. For symbol values with no spaces: "symbol1=value1 symbol2=value2 ...". When a value contains spaces, enclose the value in single quotes: "symbol1='value 1 with spaces' symbol2='value 2 with spaces' ...". To embed a single quote in a value, use two single quotes: "NAME=O''Brian".

- `--job-encoding` | `--je` (string)

  - The encoding that should be used to read the JCL into the z/OSMF JCL reader. JCL will be converted into this codepage from UTF-8 for the JES subsystem to parse.

- `--job-record-length` | `--jrl` (number)

  - The logical record length of the JCL being submitted.

    Default value: 80

- `--job-record-format` | `--jrf` (string)

  - The record format of the JCL being submitted, where V is variable, and F is fixed.

    Default value: F
    Allowed values: F, V

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Submit the JCL in the file "iefbr14.txt" via standard in:

  - `zowe zos-jobs submit stdin < iefbr14.txt`

- Submit the JCL in the file "iefbr14.txt" via standard in from the output of another command:

  - `cat iefbr14.txt | zowe zos-jobs submit stdin`

### zowe › zos-jobs › submit › uss-file

Submit a job (JCL) contained in a USS file. The command does not pre-validate the USS file path. The command presents errors verbatim from the z/OSMF Jobs REST endpoints. For more information about z/OSMF Jobs API errors, see the z/OSMF Jobs API REST documentation.

#### Usage

zowe zos-jobs submit uss-file <file> [options]

#### Positional Arguments

- `file` (string)

  - Path to the USS file that contains the JCL to submit.

#### Options

- `--wait-for-active` | `--wfa` (boolean)

  - Wait for the job to enter ACTIVE status before completing the command.

- `--wait-for-output` | `--wfo` (boolean)

  - Wait for the job to enter OUTPUT status before completing the command.

- `--view-all-spool-content` | `--vasc` (boolean)

  - Print all spool output. If you use this option you will wait for the job to complete.

- `--directory` | `-d` (string)

  - The local directory you would like to download the output of the job. Creates a subdirectory using the jobID as the name and files are titled based on DD names. If you use this option you will wait for the job to complete.

- `--extension` | `-e` (string)

  - A file extension to save the job output with. Default is '.txt'.

- `--jcl-symbols` | `--js` (string)

  - A string of JCL symbols to use for substitution. For symbol values with no spaces: "symbol1=value1 symbol2=value2 ...". When a value contains spaces, enclose the value in single quotes: "symbol1='value 1 with spaces' symbol2='value 2 with spaces' ...". To embed a single quote in a value, use two single quotes: "NAME=O''Brian".

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Submit the JCL in the USS file "/a/ibmuser/compile.jcl":

  - `zowe zos-jobs submit uss-file "/a/ibmuser/compile.jcl"`

- Submit the JCL in the USS file "/a/ibmuser/compile.jcl", wait for the job to complete and print all output from the job:

  - `zowe zos-jobs submit uss-file "/a/ibmuser/compile.jcl" --view-all-spool-content`

## zowe › zos-jobs › view

View details of z/OS jobs on spool/JES queues.

### zowe › zos-jobs › view › all-spool-content

View the contents of each spool file from a z/OS job on spool/JES queues. The command does not pre-validate the JOBID. The command presents errors verbatim from the z/OSMF Jobs REST endpoints.

#### Usage

zowe zos-jobs view all-spool-content <jobid> [options]

#### Positional Arguments

- `jobid` (string)

  - The z/OS JOBID of the job containing the spool files you want to view. No pre-validation of the JOBID is performed.

#### Options

- `--encoding` | `--ec` (string)

  - Download the spool file content with encoding mode, which means that data conversion is performed using the file encoding specified.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- View all spool files for the job with job ID JOB00234:

  - `zowe zos-jobs view all-spool-content JOB00234`

### zowe › zos-jobs › view › job-status-by-jobid

View status details of a single z/OS job on spool/JES queues. The command does not prevalidate the JOBID. The command presents errors verbatim from the z/OSMF Jobs REST endpoints (expect for "no jobs found").

#### Usage

zowe zos-jobs view job-status-by-jobid <jobid> [options]

#### Positional Arguments

- `jobid` (string)

  - The z/OS JOBID of the job you want to view. No prevalidation of the JOBID is performed.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- View status and other details of the job with the job ID JOB00123:

  - `zowe zos-jobs view job-status-by-jobid j123`

- Print only the status (for example, "OUTPUT" or "ACTIVE") of the job with the job ID JOB00123:

  - `zowe zos-jobs view job-status-by-jobid j123 --response-format-filter status --response-format-type string`

### zowe › zos-jobs › view › spool-file-by-id

View the contents of a spool file from a z/OS job on spool/JES queues. The command does not pre-validate the JOBID or spool ID. The command presents errors verbatim from the z/OSMF Jobs REST endpoints.

#### Usage

zowe zos-jobs view spool-file-by-id <jobid> <spoolfileid> [options]

#### Positional Arguments

- `jobid` (string)

  - The z/OS JOBID of the job containing the spool file you want to view. No pre-validation of the JOBID is performed.

- `spoolfileid` (number)

  - The spool file ID number for the spool file to view. Use the "zowe zos-jobs list spool-files-by-jobid" command to obtain spool ID numbers.No pre-validation of the ID is performed.

#### Options

- `--encoding` | `--ec` (string)

  - Download the spool file content with encoding mode, which means that data conversion is performed using the file encoding specified.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- View the spool file with ID 4 for the job with job ID JOB00123:

  - `zowe zos-jobs view spool-file-by-id JOB00123 4`

## zowe › zos-logs

Interact with z/OS logs.

## zowe › zos-logs › list

List z/OS logs by invoking z/OSMF REST API.

### zowe › zos-logs › list › logs

List z/OS operlog within a time range.

Use this operation to get the z/OS operations logs. It invokes z/OSMF REST API to retrieve logs.

Executing 'zowe zos-logs list logs' will by default return logs from current time and backwards to 10 minutes before.

Note: OPERLOG needs to be configured on z/OS server.

#### Usage

zowe zos-logs list logs [options]

#### Options

- `--start-time` | `--st` (string)

  - Specify the time in ISO-8601 time format from when z/OSMF will start to retrieve the logs. For example, '2021-01-26T03:33:18.065Z', '2021-01-26T11:33:18.065+08:00'. Default is the current time.

- `--direction` | `-d` (string)

  - Specify the direction when retrieving the message log. Either 'forward' or 'backward' is valid, case insensitive.

    Default value: backward
    Allowed values: forward, backward

- `--range` | `-r` (string)

  - Specify a time range in which the logs will be retrieved. The format is like nnnu, nnn is 1-999, u is one of 's', 'm', 'h', for example, '999s', '20m', '3h'.

    Default value: 10m

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- List logs starting from '2021-07-26T03:38:37.098Z' and forwards to 5 minutes later:

  - `zowe zos-logs list logs --start-time 2021-07-26T03:38:37.098Z --range 5m --direction forward`

- List logs starting from '2021-07-26T03:38:37.098Z' and forwards to 5 minutes later. Alias version of the above command:

  - `zowe zos-logs list logs --st 2021-07-26T03:38:37.098Z -r 5m -d forward`

- List logs starting from '2021-07-26T03:38:37.098Z' and backwards to 5 minutes before:

  - `zowe zos-logs list logs --start-time 2021-07-26T03:38:37.098Z --range 5m`

## zowe › zos-ssh

Issue z/OS USS commands remotely using an SSH session. Output from the commands is displayed on the local terminal.

## zowe › zos-ssh › issue

Issue a z/OS USS command.

### zowe › zos-ssh › issue › command

Issue a z/OS USS command

Note: The common CLI 'Base Connection Options' of token-type and token-value are not applicable to the ssh command, since the ssh service is not accessible through APIML.

#### Usage

zowe zos-ssh issue command <command> [options]

#### Positional Arguments

- `command` (string)

  - z/OS USS command to issue.

#### Options

- `--cwd` (string)

  - Working directory in which to execute the command.

#### z/OS Ssh Connection Options

- `--host` | `-H` (string)

  - The z/OS SSH server host name.

- `--port` | `-P` (number)

  - The z/OS SSH server port.

    Default value: 22

- `--user` | `-u` (string)

  - Mainframe user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe password, which can be the same as your TSO password.

- `--privateKey` | `--key` | `--pk` (string)

  - Path to a file containing your private key, that must match a public key stored in the server for authentication

- `--keyPassphrase` | `--passphrase` | `--kp` (string)

  - Private key passphrase, which unlocks the private key.

- `--handshakeTimeout` | `--timeout` | `--to` (number)

  - How long in milliseconds to wait for the SSH handshake to complete.

#### Profile Options

- `--ssh-profile` | `--ssh-p` (string)

  - The name of a (ssh) 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

- `--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

- Issue a simple command, giving the working directory:

  - `zowe zos-ssh issue command "npm install express" --cwd /u/cicprov/mnt/CICPY01I/bundles/myapp`

## zowe › zos-tso

Issue TSO commands and interact with TSO address spaces.

## zowe › zos-tso › issue

Issue TSO commands.

### zowe › zos-tso › issue › command

Creates a TSO address space, issues a TSO command through the newly created address space, waits for the READY prompt to print the response, and terminates the TSO address space. All response data are returned to the user up to (but not including) the TSO 'READY' prompt.

#### Usage

zowe zos-tso issue command <commandText> [options]

#### Positional Arguments

- `commandText` (string)

  - The TSO command to issue.

#### Options

- `--suppress-startup-messages` | `--ssm` (boolean)

  - Suppress console messages from start of address space.

    Default value: true

- `--stateful` | `--sf` (boolean)

  - Statefulness of address space created for TSO command. This option is not supported when --suppress-startup-messages is set to false.

    Default value: false

#### TSO ADDRESS SPACE OPTIONS

- `--account` | `-a` (string)

  - Your z/OS TSO/E accounting information.

- `--character-set` | `--cs` (string)

  - Character set for address space to convert messages and responses from UTF-8 to EBCDIC.

    Default value: 697

- `--code-page` | `--cp` (string)

  - Codepage value for TSO/E address space to convert messages and responses from UTF-8 to EBCDIC.

    Default value: 1047

- `--columns` | `--cols` (number)

  - The number of columns on a screen.

    Default value: 80

- `--logon-procedure` | `-l` (string)

  - The logon procedure to use when creating TSO procedures on your behalf.

    Default value: IZUFPROC

- `--region-size` | `--rs` (number)

  - Region size for the TSO/E address space.

    Default value: 4096

- `--rows` (number)

  - The number of rows on a screen.

    Default value: 24

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) profile to load for this command execution.

- `--tso-profile` | `--tso-p` (string)

  - The name of a (tso) 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

- `--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.

#### Examples

- Issue the TSO command "status" to display information about jobs for your user ID.:

  - `zowe zos-tso issue command "status"`

## zowe › zos-tso › ping

Ping a TSO address space, from which you previously started and received a token (a.k.a 'servelet-key').

### zowe › zos-tso › ping › address-space

Ping a TSO address space, from which you previously started and received a token (a.k.a 'servlet-key').

#### Usage

zowe zos-tso ping address-space <servletKey> [options]

#### Positional Arguments

- `servletKey` (string)

  - The servlet key from a previously started TSO address space.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Ping the TSO address space identified by IBMUSER-329-aafkaaoc:

  - `zowe zos-tso ping address-space IBMUSER-329-aafkaaoc`

## zowe › zos-tso › receive

Receive message from TSO address space app

### zowe › zos-tso › receive › app

Receive message from TSO address space app,

#### Usage

zowe zos-tso receive app [options]

#### TSO ADDRESS SPACE OPTIONS

- `--account` | `-a` (string)

  - Your z/OS TSO/E accounting information.

- `--character-set` | `--cs` (string)

  - Character set for address space to convert messages and responses from UTF-8 to EBCDIC.

    Default value: 697

- `--code-page` | `--cp` (string)

  - Codepage value for TSO/E address space to convert messages and responses from UTF-8 to EBCDIC.

    Default value: 1047

- `--columns` | `--cols` (number)

  - The number of columns on a screen.

    Default value: 80

- `--logon-procedure` | `-l` (string)

  - The logon procedure to use when creating TSO procedures on your behalf.

    Default value: IZUFPROC

- `--region-size` | `--rs` (number)

  - Region size for the TSO/E address space.

    Default value: 4096

- `--rows` (number)

  - The number of rows on a screen.

    Default value: 24

#### Required Options

- `--app-key` | `--ak` (string)

  - App key of application running at TSO address space, app key should be the value established when app instance was started

- `--servlet-key` | `--sk` (string)

  - Servlet Key of TSO address space

#### Options

- `--receive-until-ready` | `--rur` (boolean)

  - Receives data until keyword is received or timeout

    Default value: false

- `--timeout` | `-t` (number)

  - Timeout length in seconds, all data at the time of timeout will be returned to user

    Default value: 600

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) profile to load for this command execution.

- `--tso-profile` | `--tso-p` (string)

  - The name of a (tso) 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

- `--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.

## zowe › zos-tso › send

Send data to TSO and collect responses until the prompt is reached.

### zowe › zos-tso › send › address-space

Send data to the TSO address space, from which you previously started and received a token (a.k.a 'servlet-key').

#### Usage

zowe zos-tso send address-space <servletKey> [options]

#### Positional Arguments

- `servletKey` (string)

  - The servlet key from a previously started TSO address space.

#### Required Options

- `--data` (string)

  - The data to which we want to send to the TSO address space represented by the servlet key.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- "Send the TIME TSO command to the TSO address space identified by IBMUSER-329-aafkaaoc":

  - `zowe zos-tso send address-space IBMUSER-329-aafkaaoc --data "TIME"`

### zowe › zos-tso › send › app

Send message to an application at a TSO address space,

#### Usage

zowe zos-tso send app [options]

#### TSO ADDRESS SPACE OPTIONS

- `--account` | `-a` (string)

  - Your z/OS TSO/E accounting information.

- `--character-set` | `--cs` (string)

  - Character set for address space to convert messages and responses from UTF-8 to EBCDIC.

    Default value: 697

- `--code-page` | `--cp` (string)

  - Codepage value for TSO/E address space to convert messages and responses from UTF-8 to EBCDIC.

    Default value: 1047

- `--columns` | `--cols` (number)

  - The number of columns on a screen.

    Default value: 80

- `--logon-procedure` | `-l` (string)

  - The logon procedure to use when creating TSO procedures on your behalf.

    Default value: IZUFPROC

- `--region-size` | `--rs` (number)

  - Region size for the TSO/E address space.

    Default value: 4096

- `--rows` (number)

  - The number of rows on a screen.

    Default value: 24

#### Required Options

- `--app-key` | `--ak` (string)

  - App key of application running at TSO address space, app key should be the value established when app instance was started

- `--servlet-key` | `--sk` (string)

  - Servlet Key of TSO address space

- `--message` | `-m` (string)

  - Message payload to be sent to the TSO address space application

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) profile to load for this command execution.

- `--tso-profile` | `--tso-p` (string)

  - The name of a (tso) 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

- `--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.

## zowe › zos-tso › start

Start TSO/E address space.

### zowe › zos-tso › start › address-space

Start a TSO address space, from which you will receive a token (a.k.a 'servlet-key') for further address space interaction (e.g. termination).

#### Usage

zowe zos-tso start address-space [options]

#### TSO ADDRESS SPACE OPTIONS

- `--account` | `-a` (string)

  - Your z/OS TSO/E accounting information.

- `--character-set` | `--cs` (string)

  - Character set for address space to convert messages and responses from UTF-8 to EBCDIC.

    Default value: 697

- `--code-page` | `--cp` (string)

  - Codepage value for TSO/E address space to convert messages and responses from UTF-8 to EBCDIC.

    Default value: 1047

- `--columns` | `--cols` (number)

  - The number of columns on a screen.

    Default value: 80

- `--logon-procedure` | `-l` (string)

  - The logon procedure to use when creating TSO procedures on your behalf.

    Default value: IZUFPROC

- `--region-size` | `--rs` (number)

  - Region size for the TSO/E address space.

    Default value: 4096

- `--rows` (number)

  - The number of rows on a screen.

    Default value: 24

#### Options

- `--servlet-key-only` | `--sko` (boolean)

  - Specify this option to print only the servlet key

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) profile to load for this command execution.

- `--tso-profile` | `--tso-p` (string)

  - The name of a (tso) 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

- `--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.

#### Examples

- Start TSO/E address space:

  - `zowe zos-tso start address-space`

- Start TSO/E address space, and receive response in JSON format:

  - `zowe zos-tso start address-space --response-format-json`

- Start TSO/E address space, and print only the servlet key:

  - `zowe zos-tso start address-space --servlet-key-only`

### zowe › zos-tso › start › app

Start application at TSO address space,

#### Usage

zowe zos-tso start app [options]

#### TSO ADDRESS SPACE OPTIONS

- `--account` | `-a` (string)

  - Your z/OS TSO/E accounting information.

- `--character-set` | `--cs` (string)

  - Character set for address space to convert messages and responses from UTF-8 to EBCDIC.

    Default value: 697

- `--code-page` | `--cp` (string)

  - Codepage value for TSO/E address space to convert messages and responses from UTF-8 to EBCDIC.

    Default value: 1047

- `--columns` | `--cols` (number)

  - The number of columns on a screen.

    Default value: 80

- `--logon-procedure` | `-l` (string)

  - The logon procedure to use when creating TSO procedures on your behalf.

    Default value: IZUFPROC

- `--region-size` | `--rs` (number)

  - Region size for the TSO/E address space.

    Default value: 4096

- `--rows` (number)

  - The number of rows on a screen.

    Default value: 24

#### Required Options

- `--app-key` | `--ak` (string)

  - App key of application running at TSO address space, this app key value should be referenced when sending or receiving messages from the application instance

- `--startup` | `--sc` (string)

  - Command to be ran to start application at the TSO address space

#### Options

- `--queue-id` | `--qi` (string)

  - Queue ID of TSO address space

- `--servlet-key` | `--sk` (string)

  - Servlet Key of TSO address space

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) profile to load for this command execution.

- `--tso-profile` | `--tso-p` (string)

  - The name of a (tso) 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

- `--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.

## zowe › zos-tso › stop

Stop TSO/E address space.

### zowe › zos-tso › stop › address-space

Stop a TSO address space, from which you previously started and received a token (a.k.a 'servlet-key').

#### Usage

zowe zos-tso stop address-space <servletkey> [options]

#### Positional Arguments

- `servletkey` (string)

  - The servlet key from a previously started TSO address space.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Stop the TSO address space identified by IBMUSER-329-aafkaaoc:

  - `zowe zos-tso stop address-space IBMUSER-329-aafkaaoc`

## zowe › zos-workflows

Create and manage z/OSMF workflows on a z/OS system.

## zowe › zos-workflows › archive

Archive workflow instance in z/OSMF.

### zowe › zos-workflows › archive › active-workflow

Archive an active workflow instance in z/OSMF.

#### Usage

zowe zos-workflows archive active-workflow [options]

#### Options

- `--workflow-name` | `--wn` (string)

  - The name of the workflow to be archived.

- `--workflow-key` | `--wk` (string)

  - The workflow key of the workflow to be archived.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Archive a workflow with workflow name "testworkflow":

  - `zowe zos-workflows archive active-workflow --workflow-name "testworkflow"`

- Archive multiple workflows with workflow names starting with "test":

  - `zowe zos-workflows archive active-workflow --workflow-name "test.*"`

- Archive a workflow with workflow key "123-456-abv-xyz":

  - `zowe zos-workflows archive active-workflow --workflow-key "123-456-abv-xyz"`

## zowe › zos-workflows › create

Create a z/OSMF workflow on a z/OS system.

### zowe › zos-workflows › create › workflow-from-data-set

Create a z/OSMF workflow on a z/OS system using a data set.

#### Usage

zowe zos-workflows create workflow-from-data-set <workflowName> [options]

#### Positional Arguments

- `workflowName` (string)

  - Name of the workflow

#### Required Options

- `--data-set` | `--ds` (string)

  - Data set that contains a workflow definition.

- `--system-name` | `--sn` (string)

  - z/OS system to execute the workflow.

- `--owner` | `--ow` (string)

  - User ID of the workflow owner. This user can perform the workflow steps or delegate the steps to other users.

#### Options

- `--variables-input-file` | `--vif` (string)

  - Specifies an optional properties file that you can use to pre-specify values for one or more of the variables that are defined in the workflow definition file.

- `--variables` | `--vs` (string)

  - Includes a list of variables for the workflow. The variables that you specify here take precedence over the variables that are specified in the workflow variable input file. Make sure the value meets all regular expression requirements set for the corresponding variable.

- `--assign-to-owner` | `--ato` (boolean)

  - Indicates whether the workflow steps are assigned to the workflow owner.

- `--access-type` | `--at` (string)

  - Specifies the access type for the workflow. Public, Restricted or Private.

    Allowed values: Public, Restricted, Private

- `--delete-completed` | `--dc` (boolean)

  - Whether the successfully completed jobs to be deleted from the JES spool.

- `--overwrite` | `--ov` (boolean)

  - Replaces an existing workflow with a new workflow.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Create a workflow with name "testworkflow" using the data set "TESTID.WKFLOW" that contains the workflow definition xml on the system "TESTM1" with owner "OTHERID" and delete workflow with the same name if it already exists in z/OSMF:

  - `zowe zos-workflows create workflow-from-data-set "testworkflow" --data-set "TESTID.WKFLOW" --system-name "TESTM1" --owner "OTHERID" --overwrite`

- Create a workflow with name "testworkflow" using data set "TESTID.WKFLOW" containing workflow definition xml, on system "TESTM1" with owner "MYSYSID" and delete successfully completed jobs:

  - `zowe zos-workflows create workflow-from-data-set "testworkflow" --data-set "TESTID.WKFLOW" --system-name "TESTM1" --owner "MYSYSID" --delete-completed`

- Create a workflow with name "testworkflow" using data set "TESTID.WKFLOW" containing workflow definition xml, on system "TESTM1" with owner "MYSYSID" and with variable values in the member PROPERTIES of data set TESTID.DATA:

  - `zowe zos-workflows create workflow-from-data-set "testworkflow" --data-set "TESTID.WKFLOW" --system-name "TESTM1" --owner "MYSYSID" --variables-input-file TESTID.DATA(PROPERTIES)`

- Create a workflow with name "testworkflow" using the data set "TESTID.WKFLOW" that contains a workflow definition xml, on a system "TESTM1" with owner "MYSYSID" and with the variable name DUMMYVAR and the value DUMMYVAL. Assign it to the owner:

  - `zowe zos-workflows create workflow-from-data-set "testworkflow" --data-set "TESTID.WKFLOW" --system-name "TESTM1" --owner "MYSYSID" --variables DUMMYVAR=DUMMYVAL --assign-to-owner`

### zowe › zos-workflows › create › workflow-from-local-file

Create a z/OSMF workflow on a z/OS system using a local file.

#### Usage

zowe zos-workflows create workflow-from-local-file <workflowName> [options]

#### Positional Arguments

- `workflowName` (string)

  - Name of the workflow

#### Required Options

- `--local-file` | `--lf` (string)

  - Local file that contains workflow definition.

- `--system-name` | `--sn` (string)

  - z/OS system to execute the workflow.

- `--owner` | `--ow` (string)

  - User ID of the workflow owner. This user can perform the workflow steps or delegate the steps to other users.

#### Options

- `--variables-input-file` | `--vif` (string)

  - Specifies an optional properties file that you can use to pre-specify values for one or more of the variables that are defined in the workflow definition file.

- `--variables` | `--vs` (string)

  - Includes a list of variables for the workflow. The variables that you specify here take precedence over the variables that are specified in the workflow variable input file. Make sure the value meets all regular expression requirements set for the corresponding variable.

- `--assign-to-owner` | `--ato` (boolean)

  - Indicates whether the workflow steps are assigned to the workflow owner.

- `--access-type` | `--at` (string)

  - Specifies the access type for the workflow. Public, Restricted or Private.

    Allowed values: Public, Restricted, Private

- `--delete-completed` | `--dc` (boolean)

  - Whether the successfully completed jobs to be deleted from the JES spool.

- `--overwrite` | `--ov` (boolean)

  - Replaces an existing workflow with a new workflow.

- `--remote-directory` | `--rd` (string)

  - The remote USS directory where the files are to be uploaded. The directory has to exist.

- `--keep-files` | `--kf` (boolean)

  - Avoid deletion the uploaded files in /tmp or another specified directory after successful execution.

    Default value: false

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Create a workflow with name "testworkflow" using the local file "TESTID_WKFLOW.xml" that contains the workflow definition xml on the system "TESTM1" with owner "OTHERID" and delete workflow with the same name if it already exists in z/OSMF:

  - `zowe zos-workflows create workflow-from-local-file "testworkflow" --local-file "TESTID_WKFLOW.xml" --system-name "TESTM1" --owner "OTHERID" --overwrite`

### zowe › zos-workflows › create › workflow-from-uss-file

Create a workflow instance in z/OSMF using a USS file.

#### Usage

zowe zos-workflows create workflow-from-uss-file <workflowName> [options]

#### Positional Arguments

- `workflowName` (string)

  - Name of the workflow instance to create

#### Required Options

- `--uss-file` | `--uf` (string)

  - USS file that contains workflow definition.

- `--system-name` | `--sn` (string)

  - z/OS system to execute the workflow.

- `--owner` | `--ow` (string)

  - User ID of the workflow owner. This user can perform the workflow steps or delegate the steps to other users.

#### Options

- `--variables-input-file` | `--vif` (string)

  - Specifies an optional properties file that you can use to pre-specify values for one or more of the variables that are defined in the workflow definition file.

- `--variables` | `--vs` (string)

  - Includes a list of variables for the workflow. The variables that you specify here take precedence over the variables that are specified in the workflow variable input file. Make sure the value meets all regular expression requirements set for the corresponding variable.

- `--assign-to-owner` | `--ato` (boolean)

  - Indicates whether the workflow steps are assigned to the workflow owner.

- `--access-type` | `--at` (string)

  - Specifies the access type for the workflow. Public, Restricted or Private.

    Allowed values: Public, Restricted, Private

- `--delete-completed` | `--dc` (boolean)

  - Whether the successfully completed jobs to be deleted from the JES spool.

- `--overwrite` | `--ov` (boolean)

  - Replaces an existing workflow with a new workflow.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Create a workflow with name "testworkflow" using uss file "/path/workflow.xml" containing workflow definition, on system "TESTM1" with owner "OTHERID" and delete workflow with the same name if it already exists in z/OSMF:

  - `zowe zos-workflows create workflow-from-uss-file "testworkflow" --uss-file "/path/workflow.xml" --system-name "TESTM1" --owner "OTHERID" --overwrite`

- Create a workflow with name "testworkflow" using uss file "/path/workflow.xml" containing workflow definition, on system "TESTM1" with owner "MYSYSID" and delete successfully completed jobs:

  - `zowe zos-workflows create workflow-from-uss-file "testworkflow" --uss-file "/path/workflow.xml" --system-name "TESTM1" --owner "MYSYSID" --delete-completed`

- Create a workflow with name "testworkflow" using uss file "/path/workflow.xml" containing workflow definition, on system "TESTM1" with owner "MYSYSID" and with variable values in the member PROPERTIES of data set TESTID.DATA:

  - `zowe zos-workflows create workflow-from-uss-file "testworkflow" --uss-file "/path/workflow.xml" --system-name "TESTM1" --owner "MYSYSID" --variables-input-file TESTID.DATA(PROPERTIES)`

- Create a workflow with name "testworkflow" using uss file "/path/workflow.xml" containing workflow definition, on system "TESTM1" with owner "MYSYSID" and with variables VAR1 and VAR2 with values DUMMYVAL1 and DUMMYVAL2, and assign it to the owner:

  - `zowe zos-workflows create workflow-from-uss-file "testworkflow" --uss-file "/path/workflow.xml" --system-name "TESTM1"--variables VAR1=DUMMYVAL1,VAR2=DUMMYVAL2 --owner "MYSYSID" --assign-to-owner`

## zowe › zos-workflows › delete

Delete an active workflow or an archived workflow from z/OSMF.

### zowe › zos-workflows › delete › active-workflow

Delete an active workflow instance in z/OSMF.

#### Usage

zowe zos-workflows delete active-workflow [options]

#### Options

- `--workflow-key` | `--wk` (string)

  - Delete active workflow by specified workflow key

- `--workflow-name` | `--wn` (string)

  - Delete active workflow by specified workflow name

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- To delete a workflow instance in z/OSMF with workflow key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0":

  - `zowe zos-workflows delete active-workflow --workflow-key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0"`

- To delete a workflow instance in z/OSMF with workflow name "testWorkflow":

  - `zowe zos-workflows delete active-workflow --workflow-name "testWorkflow"`

- To delete multiple workflow instances in z/OSMF with names starting with "test":

  - `zowe zos-workflows delete active-workflow --workflow-name "test.*"`

### zowe › zos-workflows › delete › archived-workflow

Delete an archived workflow from z/OSMF.

#### Usage

zowe zos-workflows delete archived-workflow [options]

#### Options

- `--workflow-key` | `--wk` (string)

  - Delete an archived workflow by specified workflow key

- `--workflow-name` | `--wn` (string)

  - Delete an archived workflow by specified workflow name

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- To delete an archived workflow from z/OSMF with workflow key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0":

  - `zowe zos-workflows delete archived-workflow --workflow-key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0"`

- To delete an archived workflow from z/OSMF with workflow name "testWorkflow":

  - `zowe zos-workflows delete archived-workflow --workflow-name "testWorkflow"`

- To delete multiple archived workflows from z/OSMF with names beginnig with "test":

  - `zowe zos-workflows delete archived-workflow --workflow-name "test.*"`

## zowe › zos-workflows › list

List the z/OSMF workflows for a system or a sysplex with filter options.

### zowe › zos-workflows › list › active-workflow-details

Get the details of an active z/OSMF workflow.

#### Usage

zowe zos-workflows list active-workflow-details [options]

#### Options

- `--workflow-name` | `--wn` (string)

  - List active workflow details by specified workflow name.

- `--workflow-key` | `--wk` (string)

  - List active workflow details by specified workflow key.

- `--list-steps` | `--ls` (boolean)

  - Optional parameter for listing steps and their properties.

- `--steps-summary-only` | `--sso` (boolean)

  - Optional parameter that lists steps summary only.

- `--list-variables` | `--lv` (boolean)

  - Optional parameter for listing variables and their properties.

- `--skip-workflow-summary` | `--sws` (boolean)

  - Optional parameter that skips the default workflow summary.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- To list the details of an active workflow with key "7c62c790-0340-86b2-61ce618d8f8c" including its steps and variables:

  - `zowe zos-workflows list active-workflow-details --workflow-key "7c62c790-0340-86b2-61ce618d8f8c" --list-steps --list-variables`

- To list the details of an active workflow with name "testWorkflow" including its steps and variables:

  - `zowe zos-workflows list active-workflow-details --workflow-name "testWorkflow" --list-steps --list-variables`

### zowe › zos-workflows › list › active-workflows

List active workflow instance(s) in z/OSMF.
Multiple filters can be used together.
Omitting all options will list all workflows on the sysplex.

#### Usage

zowe zos-workflows list active-workflows [options]

#### Options

- `--workflow-name` | `--wn` (string)

  - Filter by workflow name. For wildcard use .*

- `--category` | `--cat` (string)

  - Filter by the category of the workflows, which is either general or configuration.

- `--system` | `--sys` (string)

  - Filter by the nickname of the system on which the workflows is/are active.

- `--owner` | `--ow` (string)

  - Filter by owner of the workflow(s) (a valid z/OS user ID).

- `--vendor` | `--vd` (string)

  - Filter by the name of the vendor that provided the workflow(s) definition file.

- `--status-name` | `--sn` (string)

  - Filter by the status of the workflow(s).

    Allowed values: in-progress, complete, automation-in-progress, canceled

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- List the workflow with name "testworkflow":

  - `zowe zos-workflows list active-workflows --workflow-name "testworkflow"`

- List multiple active workflows on the entire syspex with names containing"workflow":

  - `zowe zos-workflows list active-workflows --workflow-name ".*workflow.*"`

- List multiple active workflows on system "IBMSYS" with names beginnig with "testW" that are in status "complete":

  - `zowe zos-workflows list active-workflows --workflow-name "test.*" --system "IBMSYS" --status-name "complete"`

### zowe › zos-workflows › list › archived-workflows

List the archived z/OSMF workflows for a system or sysplex.

#### Usage

zowe zos-workflows list archived-workflows [options]

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

### zowe › zos-workflows › list › definition-file-details

Retrieve the contents of a z/OSMF workflow definition from a z/OS system.

#### Usage

zowe zos-workflows list definition-file-details <definitionFilePath> [options]

#### Positional Arguments

- `definitionFilePath` (string)

  - Specifies the location of the workflow definition file, which is either a UNIX path name or a fully qualified z/OS data set name.

#### Options

- `--list-steps` | `--ls` (boolean)

  - Optional parameter for listing steps and their properties.

- `--list-variables` | `--lv` (boolean)

  - Optional parameter for listing variables and their properties.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- To list the contents of a workflow definition stored in the UNIX file "/user/dir/workflow.xml" including its steps and variables:

  - `zowe zos-workflows list definition-file-details "/user/dir/workflow.xml" --list-steps --list-variables`

- To list the contents of a workflow definition stored in the z/OS data set "USER.DATA.SET.XML" including its steps and variables:

  - `zowe zos-workflows list definition-file-details "USER.DATA.SET.XML" --list-steps --list-variables`

## zowe › zos-workflows › start

Start a z/OSMF workflow on a z/OS system.

### zowe › zos-workflows › start › workflow-full

Will run workflow from the beginning to the end or to the first manual step.

#### Usage

zowe zos-workflows start workflow-full [options]

#### Options

- `--workflow-key` | `--wk` (string)

  - Workflow key of workflow instance to be started

- `--workflow-name` | `--wn` (string)

  - Workflow name of workflow instance to be started

- `--resolve-conflict-by` | `--rcb` (string)

  - How variable conflicts should be handled.
    Options:
    outputFileValue: Allow the output file values to override the existing values.
    existingValue: Use the existing variables values instead of the output file values.
    leaveConflict: Automation is stopped. The user must resolve the conflict manually.

    Default value: outputFileValue
    Allowed values: outputFileValue, existingValue, leaveConflict

- `--wait` | `-w` (boolean)

  - Identifies whether to wait for workflow instance to finish.

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- To start a workflow instance in z/OSMF with workflow key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0":

  - `zowe zos-workflows start workflow-full --workflow-key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0"`

- To start a workflow instance in z/OSMF with workflow key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0" and wait for it to be finished:

  - `zowe zos-workflows start workflow-full --workflow-key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0" --wait`

- To start a workflow instance in z/OSMF with workflow key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0" and if there is a conflict in variable's value use the value that is in output file:

  - `zowe zos-workflows start workflow-full --workflow-key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0" --resolve-conflict-by "outputFileValue"`

- To start a workflow instance in z/OSMF with workflow name "testWorkflow":

  - `zowe zos-workflows start workflow-full --workflow-name "testWorkflow"`

### zowe › zos-workflows › start › workflow-step

Will run given step of workflow instance plus following steps if specified by --perform-following-steps option.

#### Usage

zowe zos-workflows start workflow-step <stepName> [options]

#### Positional Arguments

- `stepName` (string)

  - Specifies the step name that will be run.

#### Options

- `--workflow-key` | `--wk` (string)

  - Workflow key of workflow instance to be started

- `--workflow-name` | `--wn` (string)

  - Workflow name of workflow instance to be started

- `--resolve-conflict-by` | `--rcb` (string)

  - How variable conflicts should be handled.
    Options:
    outputFileValue: Allow the output file values to override the existing values.
    existingValue: Use the existing variables values instead of the output file values.
    leaveConflict: Automation is stopped. The user must resolve the conflict manually.

    Default value: outputFileValue
    Allowed values: outputFileValue, existingValue, leaveConflict

- `--perform-following-steps` | `--pfs` (boolean)

  - Identifies whether to perform also following steps in the workflow instance.

    Default value: false

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- To start step "Step1" only in a workflow instance in z/OSMF with workflow key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0":

  - `zowe zos-workflows start workflow-step "Step1" --workflow-key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0"`

- To start a workflow instance in z/OSMF from step "Step1" with workflow key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0":

  - `zowe zos-workflows start workflow-step "Step1" --workflow-key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0" --perform-following-steps`

- To start step "Step1" only in a workflow instance in z/OSMF with workflow key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0"and if there is a conflict in variable's value use the value that is in output file:

  - `zowe zos-workflows start workflow-step "Step1" --workflow-key "d043b5f1-adab-48e7-b7c3-d41cd95fa4b0" --resolve-conflict-by "outputFileValue"`

- To start step "Step1" only in a workflow instance in z/OSMF with workflow name "testWorkflow":

  - `zowe zos-workflows start workflow-step "Step1" --workflow-name "testWorkflow"`

## zowe › zosmf

Retrieve and show the properties of a z/OSMF web server.

## zowe › zosmf › check

Confirm that z/OSMF is running on a specified system and gather information about the z/OSMF server for diagnostic purposes.

### zowe › zosmf › check › status

Confirm that z/OSMF is running on a system specified in your profile and gather information about the z/OSMF server for diagnostic purposes. The command outputs properties of the z/OSMF server such as version, hostname, and installed plug-ins.

#### Usage

zowe zosmf check status [options]

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Report the status of the z/OSMF server that you specified in your default z/OSMF profile:

  - `zowe zosmf check status`

- Report the status of the z/OSMF server that you specified in a supplied z/OSMF profile:

  - `zowe zosmf check status --zosmf-profile SomeZosmfProfileName`

- Report the status of the z/OSMF server that you specified manually via command line:

  - `zowe zosmf check status --host myhost --port 443 --user myuser --password mypass`

## zowe › zosmf › list

Obtain a list of systems that are defined to a z/OSMF instance.

### zowe › zosmf › list › systems

Obtain a list of systems that are defined to a z/OSMF instance.

#### Usage

zowe zosmf list systems [options]

#### Zosmf Connection Options

- `--host` | `-H` (string)

  - The z/OSMF server host name.

- `--port` | `-P` (number)

  - The z/OSMF server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (z/OSMF) user name, which can be the same as your TSO login.

- `--password` | `--pass` | `--pw` (string)

  - Mainframe (z/OSMF) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--base-path` | `--bp` (string)

  - The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

- `--protocol` (string)

  - The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

- `--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

- `--completion-timeout` | `--cto` (number)

  - The amount in time, in seconds, a REST operation should wait to complete before timing out

- `--establish-connection-timeout` | `--ecto` (number)

  - The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

#### Profile Options

- `--zosmf-profile` | `--zosmf-p` (string)

  - The name of a (zosmf) 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

- `--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.

#### Examples

- Obtain a list of systems defined to a z/OSMF instance with your default z/OSMF profile:

  - `zowe zosmf list systems`

- Obtain a list of systems defined to a z/OSMF instance for the specified z/OSMF profile:

  - `zowe zosmf list systems --zosmf-profile SomeZosmfProfileName`

- Obtain a list of the systems defined to a z/OSMF instance that you specified in the command line:

  - `zowe zosmf list systems --host myhost --port 443 --user myuser --password mypass`