diff --git a/docs/developer-guide/dev-building-zowe.md b/docs/developer-guide/dev-building-zowe.md new file mode 100644 index 0000000000..fe2b70297d --- /dev/null +++ b/docs/developer-guide/dev-building-zowe.md @@ -0,0 +1,60 @@ + +Zowe source code is organized into a number of repositories at github.com/zowe. + +Individual repositories create + +The file `manifest.json.template` lists which build component pieces should be aggregated into a Zowe z/OS build. Components pieces are collected from [https://zowe.jfrog.io](https://zowe.jfrog.io). + +### binaryDependencies + +This is a ist of the components to be pulled into the build + +For example, if the entry is +``` +"org.zowe.zlux.zlux-core": { + "version": "~1.17.0-STAGING", + "artifact": "*.pax" + }, +``` +then the build will look for a tile that starts `zlux-core` and ends in `.pax` and take the latest one. + +If the entry is, + +``` +"org.zowe.zlux.zlux-core": { + "version": "1.18.0-RC", + "repository": "libs-snapshot-local", + "artifact": "zlux-core-1.18.0-20201208.210357.pax" + }, +``` + +then this is an exact match to the pax file `zlux-core-1.18.0-20201208.210357.pax` at the repository path `libs-snapshot-local`. + + +| Component name | Repository Artifact | +| --------- | --------- | --------- | +| "org.zowe.zlux.zlux-core" | libs-snapshot-local | zlux-core-1.17.0-20201109.000619.pax| +| org.zowe.zlux.zss-auth" | libs-snapshot-local | zss-auth-1.17.0-20201108.235242.pax | +| org.zowe.zlux.sample-angular-app | libs-snapshot-local | sample-angular-app-1.17.0-20201109.000055.pax | +| org.zowe.zlux.sample-iframe-app | libs-snapshot-local | sample-iframe-app-1.17.0-20201108.235404.pax | +| org.zowe.zlux.sample-react-app | libs-snapshot-local | ample-react-app-1.17.0-20201108.235926.pax | +| org.zowe.zlux.tn3270-ng2" | libs-snapshot-local | tn3270-ng2-1.17.0-20201108.235851.pax | +| org.zowe.zlux.vt-ng2" | libs-snapshot-local | vt-ng2-1.17.0-20201108.235839.pax | +| org.zowe.zlux.zlux-editor | libs-snapshot-local |zlux-editor-1.17.0-20201108.234456.pax | +| org.zowe.zlux.zlux-workflow | libs-snapshot-local |zlux-workflow-1.17.0-20201108.235938.pax | +| org.zowe.zlux.zosmf-auth" | libs-snapshot-local |zosmf-auth-1.17.0-20201108.235615.pax | +| org.zowe.zss | libs-snapshot-local |zss-1.17.0-rc-61-20201109155110.pax | + + + +| org.zowe.explorer.jobs | | +| org.zowe.explorer.data.sets | | +| org.zowe.explorer-jes | | +| org.zowe.explorer-mvs | | +| org.zowe.explorer-uss | | +| org.zowe.explorer-ui-server | | +| org.zowe.apiml.sdk.zowe-install | zowe-install-1.17.1.zip | .pax/mediation/ | + +| org.zowe.keyring-utilities | keyring-util-1.0.4 | .pax/keyring-util/keyring-util", + + \ No newline at end of file diff --git a/docs/developer-guide/dev-pipeline-zowe.md b/docs/developer-guide/dev-pipeline-zowe.md new file mode 100644 index 0000000000..e69de29bb2 diff --git a/docs/user-guide/cli-db2plugin.md b/docs/user-guide/cli-db2plugin.md index 899c9daa22..9f62f34bbf 100644 --- a/docs/user-guide/cli-db2plugin.md +++ b/docs/user-guide/cli-db2plugin.md @@ -149,13 +149,33 @@ If the utility `db2connectactivate` has not been executed against the Db2 databa ## Creating a user profile -Before you start using the IBM Db2 plug-in, create a profile. - -Issue the command `-DISPLAY DDF` in the SPUFI or ask your DBA for the following information: +Before you start using the IBM Db2 plug-in, create a profile with details of the Db2 system you're connecting to. - The Db2 server host name - The Db2 server port number - The database name (you can also use the location) + +To get the Db2 system information, the following two methods can be used. + +- Issue the command `-DISPLAY DDF` in the Db2 SPUFI command on z/OS + +or + +- View the JES spool for the MSTR job for the Db2 subsystem and search for the message `DSNL004I`. For example, for the database DI2E the JES job `DI2EMSTR` will have an entry with similar to: +``` +DSNL004I #DI2E DDF START COMPLETE 025 + LOCATION DSNV102E + LU GBIBMIYA.IYCYZDBE + GENERICLU -NONE + DOMAIN host.ip.address.com + TCPPORT 40100 + SECPORT 30100 +``` + +The DOMAIN is used for the <hostname>, the TCPPORT for the <port> and the LOCATION for the <database> in the zowe create profile command. + +In addition to the host, port and database you'll need + - The user name - The password - If your Db2 systems use a secure connection, you can also @@ -178,4 +198,4 @@ Command Error: DB2 ODBC Driver Error: [node-ibm_db] Error in ODBCConnection::QuerySync while executing query.Error Details: Error: [IBM][CLI Driver][DB2] SQL0805N Package "DSNV112E.NULLID.SYSSH200.5359534C564C3031" was not found. ``` -If you receive this error, a user with `DBADM` authority must run the `BIND` command. This will typically be done by a Db2 System Programmer. More information can be found in the [Db2 product documentation](https://medium.com/r/?url=https%3A%2F%2Fwww.ibm.com%2Fsupport%2Fproducthub%2Fdb2%2Fdocs%2Fcontent%2FSSEPGG_11.5.0%2Fcom.ibm.db2.luw.admin.cmd.doc%2Fdoc%2Fr0001935.html) and [The Bind process](https://medium.com/r/?url=https%3A%2F%2Fwww.ibm.com%2Fsupport%2Fknowledgecenter%2FSSEPEK_10.0.0%2Fapsg%2Fsrc%2Ftpc%2Fdb2z_bindprocess.html). \ No newline at end of file +If you receive this error, a user with `DBADM` authority must run the `BIND` command. This will typically be done by a Db2 System Programmer. More information can be found in the [Db2 product documentation](https://medium.com/r/?url=https%3A%2F%2Fwww.ibm.com%2Fsupport%2Fproducthub%2Fdb2%2Fdocs%2Fcontent%2FSSEPGG_11.5.0%2Fcom.ibm.db2.luw.admin.cmd.doc%2Fdoc%2Fr0001935.html) and [The Bind process](https://medium.com/r/?url=https%3A%2F%2Fwww.ibm.com%2Fsupport%2Fknowledgecenter%2FSSEPEK_10.0.0%2Fapsg%2Fsrc%2Ftpc%2Fdb2z_bindprocess.html).