zowe › profiles › create › rse-profile🖨️

A profile to issue commands to a z/OS system with a working Zowe REST server,Mediation Layer, or IBM RSE (Remote System Explorer) API server installation.

Usage

zowe profiles create rse-profile <profileName> [options]

Positional Arguments

• profileName (string)

  • Specifies the name of the new rse profile. You can load this profile by using the name on commands that support the "--rse-profile" option.

Zowe REST Connection Options

• --host | -H (string)

  • The z/OS host name running the Zowe REST API.

• --port | -P (number)

  • The server port used by the REST API.

    Default value: 6800

• --user | -u (string)

  • The user name for the Zowe REST API operations.

• --password | --pass (string)

  • The password of the user for the Zowe REST API operations.

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

  • Reject self-signed certificates.

    Default value: true

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

  • The base path of the API for the REST API operations.

    Default value: rseapi

• --protocol | --protocol (string)

  • http or https, depending whether a TLS handshake is required to access REST API.

    Default value: https

• --encoding | --ec (string)

  • The encoding for download and upload of z/OS data set and USS files. The encoding should be specified in the form of "IBM-1047".

Options

• --overwrite | --ow (boolean)

  • Overwrite the rse profile when a profile of the same name exists.

• --disable-defaults | --dd (boolean)

  • Disable populating profile values of undefined properties with default values.

Examples

• Create an RSE API profile named 'myRseApiProfile' to connect to z/OS using the RSE API server at host zos123 that runs on port 6800 and has a base path of 'rseapi' and uses the 'http' protocol. An example base URL to RSE API would be: 'http://zos123:6800/rseapi/api/v1/':

  • zowe profiles create rse-profile myRseApiProfile --host zos123 --port 6800 --user ibmuser --pass myp4ss --bp rseapi --protocol http --ru false Copy

• Create a profile named 'myZoweRestProfile' to connect to z/OS using the Zowe REST APIs at host zos123 that runs the Zowe REST API server on port 8443, requires a TLS handshake using 'https' with SSL certificates, and has a default encoding of IBM-285. An example base URL to Zowe REST API would be: 'https://zos123:6800/api/v1/':

  • zowe profiles create rse-profile myZoweRestProfile --host zos123 --port 8443 --user ibmuser --pass myp4ss --ru false --protocol https --ec IBM-285 Copy