Migrating a CSM database from a previous release


This procedure is required only if you are migrating from MainView AutoOPERATOR version 5.1.xx or earlier. If you are migrating from MainView AutoOPERATOR 6.1.xx or later, you only need to use the REPRO command to copy the CSM repository to a new repository that the newer release of CSM PAS will use.

Note

The information contained in this section is part of the set of procedures described in Accessing-CSM, which you must complete before using CSM for the first time.

To migrate a CSM database from a previous release

  1. Log on to a terminal session and access the CSM Global Overview panel (as shown in Figure 1).

    Figure 1. CSM Global Overview panel

    BMC Software ------------------ Global Overview ------------------ AutoOPERATOR
    COMMAND ===>                                                   SCROLL ===> CSR
                                                                      TGT ---  AO6A
    Primary Commands: EXCeption  Group     SORT    SAVE      ADD
                      CALendar   CANCEL    UNsort  CONVERT   BUild
                      Locate     CMDSHOW   Xref    SAVERULE

    Line Command - Enter "/" to Select Action
    LC   Object   Group    System   Actual       Desired      Ind   Type
         ________ ________ ________ ____________ ____________ _____ ________
    ___ AAOCSM07  AO6A     SJSC                                     STC-NORM
    ___ AAOCSM08  AO6A     SJSC                                     STC-NORM
    ___ AAOCSM09  AO6A     SJSC                                     STC-NORM
    ___ AAOCSM10  AO6A     SJSC                                     STC-NORM
    ___ CSBEMSTR  AO61     SJSE     STARTING     UP            XE   STC-NORM
    ___ MVS
    ******************************* Bottom of data ********************************
  2.  On the COMMAND line, enter the CONVERT primary command. The CSM Conversion panel is displayed (see Figure 2).

    Figure 2. CSM Conversion panel

    B ---------------------------------------------------------------------- ERATOR
    C | BMC Software ----- CSM Conversion - Input data ------ AutoOPERATOR | > CSR
      | COMMAND ===>                                                       |   AO6A
    P |                                                                    |
      | Specify the name of the data set and the member containing the CSM |
      | objects to be converted into v6.1 format and stored in the         |
      | repository data set ESP.CAN.MV3905.AO61.BBIREPS                    |
    L |                                                                    | pe
      | Data Set Name ===> ____________________________________________    | ____
    _ |                                                                    | NORM
    _ |        Member ===> _______                                         | NORM
    _ |                                                                    | NORM
    _ | Specify the name of a data set where the Conversion Log will be    | NORM
    _ | written. If you specify a nonexistent data set it will be allocated|
    * | dynamically.                                                       | ******
      |                                                                    |
      | Data Set Name ===> ____________________________________________    |
      |                                                                    |
      |   Disposition ===> ___ (SHR/MOD)                                   |
      |                                                                    |
      |   Enter END command to process and continue with the CSM Group     |
      |   definitions or enter CANCEL to leave                             |
      ----------------------------------------------------------------------
  3. Follow the instructions on the panel.
    1. In the first Data Set Name field, enter the name of the CSM data set that you are replacing.
    2. In the Member field, enter the member name (for example: CSM ssid).
    3. In the second Data Set Name field, specify the name of a data set where the conversion process logs information that is related to the conversion.The data set may be a preallocated RECFM=FB, LRECL=80 data set or the data set may be dynamically allocated with these DCB attributes: RECFM=FB, LRECL=80, BLKSIZE=23680.
    4. In the Disposition field, specify one of the following choices:
      • MOD causes the Routine to append data to the end of the sequential data set.
      • SHR causes the Routine to write data at the beginning of the data set.
      • The resulting Conversion Log contains information such as the conversion date and time, user ID, the input database name, the Group name, and a list of the converted objects and exceptions.
      • After you enter this information, the Group Detail Control panel is displayed.
  4. On the Group Detail Control panel, enter information related to the CSM group that is being converted. 

    Note

    You must add the Rule Set ID that you specify in the Rule Set ID field on this panel to the RULESET parameter in BBPARM member AAOPRM00 (refer to Step 2).

    Figure 3 shows an example of a completed Group Detail Control panel.

    Figure 3. Completed Group Detail Control panel

    BMC Software  ----------- Group Detail Control - Add    ---------- AutoOPERATOR
    COMMAND ===>                                                      TGT --- KMZ1

    Group Name        ===> SYSB____
    Command Prefix    ===> CSMKM___________

    Rule information:
    Ruleset Dataset   ===> BAOKMZ.AAO61.KMZ1.UBBPARM
    Ruleset Id        ===> G2      Rule Prefix ===> ACM1     Suffix ===> 0001

    Object Statistics:
    Dataset Name      ===> BAOKMZ.KMZ1.OFFLOAD
    Disposition       ===> MOD

    Application information:
    Author            ===> BAOKMZ2
    Description       ===> GROUP LIST FOR SYSB




    Enter END command to process and return or CANCEL to leave

    The default name of the CSM group is created from the last four characters of the CSMssid member that is being converted. You can choose your own group name by typing over the default name. If the name that you choose already exists, a pop-up window is displayed, asking for a new Group Name.

  5. Enter a new Group Name in the pop-up window (Figure 4) or enter CANCEL to terminate the conversion.

    Figure 4. Pop-up window for new Group name

    BMC Software ---- CSM Conversion - Group name -------------------- AutoOPERATOR
    COMMAND ===>

    Group name NS61 already exists. Specify new name for CSM Group.

      Group Name ===> ________

     Enter END command to process or CANCEL to leave
  6. As the conversion progresses, a pop-up window (Figure 5) is displayed and as every five objects are converted, the counter is updated.

    Figure 5. CSM Conversion Status pop-up window

      BMC Software ----- CSM Conversion Status ----- AutoOPERATOR





                        CSM Conversion in Progress


                       15  of 164  objects converted
  7. When the conversion is complete, the CSM Conversion Log is displayed (Figure 6).

    Figure 6. CSM Conversion Log

    ********************************* Top of Data ********************************
    BMC Software                  CSM Conversion Log


    Input database .... BAONIS.NS61.BBPARM(CSMNEW)
    Converted by ...... BAONIS2 at: 16:54 on: 10/05/2000
    New Group ......... NEW
    Objects processed . 50
    Conversion status . Successful for group NEW. No exceptions.

     Objects    Exception Notes
     -------    ---------------
     AAOCSMN1
     AAOCSMN2
     AAOCSMN3
     AAOCSMN4
     AAOCSMN5
     AAOCSMN6

    During conversion, you might encounter conflicts or mismatches with object definitions. For more information about resolving object-definition mismatches, refer to Resolving-object-definition-conflicts-after-converting.

  8.  Press End from the CSM Conversion Log.The converted CSM objects and newly created Group are displayed on the CSM Global Overview panel (Figure 7).

    Figure 7. Completed CSM data set conversion

    BMC Software -------------- Global Overview ------------- Conversion Successful
    COMMAND ===>                                                   Scroll ===> PAGE
                                                                      TGT ---  NS61
    Primary Commands: EXCeption  Group     SORT    SAVE      ADD
                      CALendar   CANCEL    UNsort  CONVERT
                      Locate     CMDSHOW   Xref    SAVERULE

    Line Command - Enter "/" to Select Action
    LC  Object    Group-Id System   Actual       Desired      Ind   Type
        ________ ________ ________ ____________ ____________ _____ ________
    ___ AAOQAS01 NS61              UNKNOWN      UNKNOWN
    ___ AAONS61  NS61              UNKNOWN      UNKNOWN
    ___ CAS      NS61              UNKNOWN      UNKNOWN
    ___ CICS11   NS61              UNKNOWN      UNKNOWN
    ___ IMS71X   NS61              UNKNOWN      UNKNOWN
    ___ TSO      NS61              UNKNOWN      UNKNOWN
    ___ MVS
    ******************************* Bottom of data *******************************
  9. Repeat Step 2 through Step 8 for each version 4.1 or 5.1 CSM data set and member name to be converted.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*