COMBINE


Use the COMBINE command to combine Db2, IMS, and MQ message types into a more manageable group or to expand types that have been combined by default.

You can also use the COMBINE command to associate jobnames to each of the WAS servers you want to include.

Syntax

To combine Db2 or MQ connection types in the applications input data, use the following format:

COMBINE <name> SUBSYSTYPE=<DB2 or MQ>
               SID=<list of system Ids>
               SUBSYS=<list of subsystem Ids>
               CONNTYPE=<list of connection types>

To combine IMS message types in the applications input data, use the following format:

COMBINE <name> SUBSYSTYPE=IMS
               SID=<list of system Ids>
               SUBSYS=<list of subsystem Ids>
               REGTYPE=<list of message types>

To associate jobnames to WAS servers, use the following format:

COMBINE <server> SUBSYSTYPE=WAS
                 SID=<list of system Ids>
                 JOBNAME=<list of jobnames>

Syntax explanations

  • <name> is the name of the combined (or separated) message types. This value can be one of the message types in Subsystem-connection-and-region-types-and-transaction-groupings or can be one of the following types:
    • For Db2
      • TSOBATCH
      • BATCH
      • IMS
      • IMSON
      • DDF
      • MPP
      • BMP
    • For IMS
      • MPPGROUP
      • BMPGROUP
      • FPGROUP
      • IMSMPP
      • IMSBMP
      • IMSFP
      • IMSON
      • IMS
    • For MQ
      • TSOBATCH
      • BATCH
      • TSO
      • BMP
      • IMS
      • IMSON
  • <server> is the name of a WAS server.
  • SUBSYSTYPE defines the data source to which this command applies:
    • DB2—All Db2 records
    • IMS—All IMS records
    • MQ—All MQ records
    • WAS—All WAS records
  • SID specifies a list of Logical System IDs to which this command applies. The default is all logical systems. Specifying a SUBSYS without a SID enables this command to apply to the subsystems listed no matter which logical system they are running on. If all subsystem identifiers are unique across the complex, then BMC recommends that SID not be coded. If subsystems are moved to a different logical system, the command will not have to be changed.
  • SUBSYS specifies a list of IMS, MQ, or Db2 subsystem names to which this command applies. The default is all subsystems. The combination of SID and SUBSYS forms a key value used internally to apply the command to each record. The search order for this key is SID value SUBSYS value followed by just a SUBSYS value followed by just a SID value followed by neither value. Eliminating both the SID and SUBSYS parameters creates a new default set of values, which will be used against all data records.
  • REGTYPE specifies the IMS message types you want to combine or separate. The value used must be one of the original message types listed for the subsystem. It cannot be a UIE extension or a default combine value.
  • CONNTYPE specifies the Db2 or MQ connection types you want to combine or separate. The value used must be one of the original connection types listed for the subsystem. It cannot be a UIE extension or a default combine value.
  • JOBNAME specifies a jobname or list of jobnames. You should specify the name for the WAS control job.

Rules

  • The command order is important. The command values are processed in the order that they appear in the input stream within SID and SUBSYS. If the same message type is listed more than once, the last occurrence is used to process the data.
  • <name> is a required value for a SUBSYSTYPE of Db2, IMS, or MQ.
  • <server> is a required for a SUBSYSTYPE of WAS.
  • The SUBSYSTYPE parameter is required.
  • The SID parameter is optional.
  • The SUBSYS parameter is optional.
  • The REGTYPE parameter is required for IMS.
  • The CONNTYPE parameter is required for Db2 or MQ.
  • REGTYPE and CONNTYPE are interchangeable.

    For valid REGTYPE and CONNTYPE, see Subsystem-connection-and-region-types-and-transaction-groupings.

  • JOBNAME is required for WAS.

Examples

  • To combine all of the IMS Fast Path combinations on all IMS subsystems into a message type of IMSFP, code the following commands:

    COMBINE IMSFP SUBSYSTYPE=IMS
                  REGTYPE=FP,WFP,QFP,MFP,WMFP,QMFP
  • To separate all of the IMS message types into the types coded in the BMC AMI Ops Monitor for IMS Offline data, code the following commands:

    COMBINE MPP  SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=MPP
    COMBINE WMPP SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=WMPP
    COMBINE QMPP SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=QMPP
    COMBINE BMP  SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=BMP
    COMBINE WBMP SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=WBMP
    COMBINE QBMP SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=QBMP
    COMBINE CMPP SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=CMPP
    COMBINE WCMP SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=WCMP
    COMBINE QCMP SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=QCMP
    COMBINE MFP  SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=MFP
    COMBINE WMFP SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=WMFP
    COMBINE QMFP SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=QMFP
    COMBINE FP   SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=FP
    COMBINE WFP  SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=WFP
    COMBINE QFP  SUBSYSTYPE=IMS
                 SUBSYS=IMSP
                 REGTYPE=QFP
  • To combine all Db2 non-subsystem transactions on all Db2 subsystems into a message type of BATCH, code the following command:

    COMBINE BATCH SUBSYSTYPE=DB2
                 CONNTYPE=TSO,DB2CALL,DLIBATCH,UTILITY,SYSDIRAC,APPDIRAC,RRSAF
  • To combine all Db2 non-subsystem transactions on subsystem DB2T only into a message type of BATCH, code the following command:

    COMBINE BATCH SUBSYSTYPE=DB2
                  SUBSYS=DB2T
                  CONNTYPE=TSO,DB2CALL,DLIBATCH,UTILITY,SYSDIRAC
                  APPDIRAC,RRSAF
  • To associate jobnames to a WAS server, code the following command:

    COMBINE WASSVR1 SUBSYSTYPE=WAS
            JOBNAME=WASCTL

 

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