zowe › profiles › create › ims-profile
An ims profile is used to issue commands in the ims command group that interact with IMS regions. The ims profile contains your IMS Operations API web server host, port, user name and password, IMS Connect host and port and IMS plex name.
Usage
zowe profiles create ims-profile <profileName> [options]
Positional Arguments
profileName
(string)- Specifies the name of the new ims profile. You can load this profile by using the name on commands that support the "--ims-profile" option.
IMS Connection Options
--host
|-H
(string)- The IMS Operations API server host name.
--port
|-P
(number)- The IMS Operations API server port.
--ims-connect-host
|--ich
(string)- The hostname of your instance of IMS Connect. This is typically the hostname of the mainframe LPAR where IMS Connect is running.
--ims-connect-port
|--icp
(number)- The port of your instance of IMS Connect. This port can be found in your IMS Connect configuration file on the mainframe.
--plex
|-x
(string)- The name of the IMS plex.
--user
|-u
(string)- The web server user name where the IMS Operations API resides.
--password
|--pass
(string)- The web server user password where the IMS Operations API resides.
--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.
Options
--overwrite
|--ow
(boolean)- Overwrite the ims profile when a profile of the same name exists.
Examples
Create a ims profile named 'ims123' to connect to IMS APIs at host zos123 and port 1490. The name of the IMS plex in this example is 'PLEX1' and the IMS region we want to communicate with has a host of zos124 and a port of 1491:
zowe profiles create ims-profile ims123 --host zos123 --port 1490 --user ibmuser --pass myp4ss --plex PLEX1 --ich zos124 --icp 1491