Space banner

   

This space provides the same content as before, but the organization of the home page has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Creating the MainView host server startup procedure

The MainView host server is a mainframe started task that provides access to MainView product data. It runs as an address space on IBM z/OS systems with a running CAS and must be started in order to support its clients:
  • Discovery Agent provides communications via the infrastructure APIs.

  • MainView Explorer (MVE) 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.

Note

MainView host server must be running in order to access all MainView products except MainView FOCAL POINT.

To create a host server startup procedure

You can use member BBMXPJCL as a model for the 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 MVE and the host server. The options are:
      • N: Do not use TLS protocol (this is the default).
      • Y: Use TLS protocol.
      • D: Use TLS protocol and accept a client certificate for logon.
      • R: Use TLS protocol and require a client certificate for logon.
      For detailed information about using TLS, see Configuring UIM server options and Creating SSL/TLS certificates for use with UIM or MainView Explorer.

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

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

      For detailed information about using TLS, see Configuring UIM server options and Creating SSL/TLS certificates for use with UIM or MainView Explorer.

    6. (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.

      For detailed information about using TLS, see Configuring UIM server options and Creating SSL/TLS certificates for use with UIM or MainView Explorer.

    7. If you changed the member name to something other than BBMXPJCL, update the PROC statement with the new member name.
  3. Save the member.
Related topic

Was this page helpful? Yes No Submitting... Thank you

Comments