Document the use of DSNL004I message for working out Db2 profile information

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",
+
+

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).
+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).