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)
-
--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 return code of a failed action
-
--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.
-
--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-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.
output customization 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
-
--user
| --username
(string)
-
--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
-
--cert-key-file
(local file path)
- The file path to a certificate key file to use for authentication
Examples