Creating the MainView host server startup procedure

• Discovery Agent provides communications via the infrastructure APIs.
• MainView Explorer provides access to MainView product data via specific views.

Multiple host servers can run in a system and communicate with the same or different CASs.

To create a host server startup procedure

1. Copy BBSAMP member, BBMXPJCL, to a procedure library. You can modify the member name to suit your organization. The member name is the name that you specify in the START command when you start the host server.
   
   
2. Modify member BBMXPJCL as follows:
   
   
   1. Change SSID=?SSID to SSID=ssid, where ssid is the subsystem ID of the CAS to which you want to connect. The default is BBCS.
      
      

   2. Change PORT=?PORT to PORT=nnnnn, where nnnnn is a unique port number for the host server. You can use any integer between 1024 through 65535. The default is 3940.

      Note

      If you change the port number from the default of 3940, you must:

      • Specify a unique port number for each application that runs on a given system image.
      • Specify the new port number when you start the client.

   3. (Optional) Use or remove the USERDS parameter to control the allocation of user data sets.The BBVDEF and BBCDEF user data sets contain customized views and configurations, respectively. You can specify the USERDS parameter as follows:

      • USERDS=template defines a template that can be made up of the TSO prefix (%UPFX), the TSO user ID (%USERID), and the data set name (%BBDEF). You can specify one or both of the user tokens, and they can appear in any order. %BBDEF, which resolves to BBVDEF or BBCDEF, is required. The default template is %UPFX.%USERID.%BBDEF. The template that you specify appears in the MainView Explorer Logon dialog box. Users cannot change the template.
        
        
      • USERDS=NO disables the allocation of user data sets. The MainView Explorer Logon dialog box is truncated; the fields that are related to the allocation of user data sets do not appear.

      If you remove the USERDS parameter from the host server startup procedure, users can define their own data set template when they log on to MainView Explorer.

      Example

      The following are examples of valid templates and the user data sets that they would allocate for a user ID of MYID01:

      • %USERID.TEST.%BBDEF allocates MYID01.TEST.BBVDEF (and BBCDEF).
      • PROD.U%BBDEF.%USERID allocates PROD.UBBVDEF.MYID01 (and UBBCDEF).
      • %USERID.&SYSNAME.%BBDEF allocates MYID01.SYSC.BBVDEF (on SYSC).

      Including the system variable &SYSNAME., as shown in the last example, enables you to use the same data set template on different system images.

   4. (Optional) Use the TLS (Transport Layer Security) parameter to enable secure connections between MainView Explorer and the host server.
      
      The options are:
      
      
      • N does not use the TLS protocol (this is the default).
      • Y uses the TLS protocol.
      • D uses the TLS protocol and accepts a client certificate for logon.
      • R uses the TLS protocol and requires a client certificate for logon.
        
        

   5. (Optional) Use the SSL (Secure Sockets Layer) parameter in place of TLS to enable secure connections between MainView Explorer and the host server. 
      
      The options for SSL are Y or N.

      SSL protocol has been deprecated and BMC recommends using TLS instead.

   6. (Optional; PTFs BQY2262 and BQY2266 applied) Use the TIMEOUT parameter to enable the time out check for MainView Explorer users. 

      The options are Y, N, or hhmm. 

      • Y sets the time out to the TWT value from SMFPRMXX if it is specified or to the JWT value if not. 
      • N is the default. 
      • hhmm is hours and minutes, in the range of 0005-2400.
        For example, a TIMEOUT value of 0100 would timeout a user after one hour of inactivity.
        
        

      If the user has AUTO REFRESH enabled with a shorter time interval than the timeout, the user will never be logged off due to the continuous activity made by AUTO REFRESH. To learn more about AUTO REFRESH, see Refreshing-view-data-in-MainView-Explorer.
      
      

   7. (Optional) Use the BBMMVE parameter when TLS=Y, D, or R is used to indicate where the TLS certificate-related information is coded.
      
      Specify the 2-digit member suffix (xx) for the parameter member BBMMVExx.
      
      
   8. If you changed the member name to something other than BBMXPJCL, update the PROC statement with the new member name.
      
      
3. Save the member.