Honoring a pseudoconversational transaction

Start of changeThis example describes how to use the end user interface (EUI) to ensure that multiple transactions, among which there is an affinity, are routed to the same target region. As before, you are working in CICSplex PLXPROD1 and are routing transactions from CICSPT01 to the target regions in CICS system group CSGTGTS1.End of change

  1. If the current context isn’t PLXPROD1, issue the command CON PLXPROD1 from the current view.
  2. Create a transaction group.
    1. From the current view, issue the command TRANGRP. The TRANGRP view is displayed, listing any transaction groups already defined in PLXPROD1.
    2. From the TRANGRP view, issue the command CRE. The Create Trangroup panel is displayed. Complete the panel as shown here:
     ---------------------- Create Trangroup for PLXPROD1 --------------------------
     COMMAND  ===>
     
      Trangroup name    ===> TRGPAY03
      Description       ===> Pseudoconversational transaction
     
      Status            ===> ACTIVE        Transaction Group Status
                                       (ACTIVE,DORMANT)
      Match Key         ===> USERID        Primary WLMDEF search criterion
                                       (USERID,LUNAME)
      Affinity Relation ===> USERID        Optional affinity relation may be:
                                       (USERID,LUNAME,GLOBAL, BAPPL)
      Affinity Lifetime ===> PCONV         Optional affinity lifetime  may be:
                                       (SIGNON,LOGON,PCONV,DELIMIT,SYSTEM, PERMANENT
                                        ACTIVITY, PROCESS)
      Create Affinity   ===>               Create Auto Affinity (YES, NO, N/A)
      Event Name        ===>               RTADEF/STATDEF, or generic
      Abend Health      ===> 0             Target ABEND Health Factor (0 - 99)
      Abend Load        ===> 0             Target ABEND Load Factor (0 - 99)
    Press Enter to create Trangroup.
    Type END or CANCEL to cancel without creating.

    Notice that the Affinity Relation and Affinity Lifetime fields must be completed. These values tell CICSPlex® SM that the transactions in this group constitute a pseudoconversational transaction (PCONV), and that this affinity lasts while those transactions are coming from the same user ID (USERID). If one of them is initiated from a different user ID, CICSPlex SM can select a different target region. Of course, the same type of affinity will then come into play in that second target region. You can ignore any fields that have been left blank. Press Enter. The TRANGRP view is redisplayed, now showing the name of the transaction group TRGPAY03.

    Note:
    For a complete description of the TRANGRP view, see TRANGRP (Transaction groups).
  3. Identify the transactions in group TRGPAY03.

    From the TRANGRP view, move the cursor to the entry for TRGPAY03, and issue ADD from the line-command field. The Add Transaction to Trangroup panel is displayed. Complete the panel as shown here:

     ------------------- Add Transaction to Trangroup for PLXPROD1 -----------------
     COMMAND  ===>
     
      Trangroup               TRGPAY03
     
          Transaction     PCONV Mode        Error
     ===> PAY2            ===> START
     ===> PAY3            ===>
     ===> PAY4            ===>
     ===> PAY5            ===> END
     ===>                 ===>
     ===>                 ===>
     ===>                 ===>
     ===>                 ===>
     ===>                 ===>
     ===>                 ===>
     
     
    Press Enter to add Transaction to Trangroup.
    Type END or CANCEL to cancel without adding.

    As you can see from this panel, there are four transactions in this group (PAY2, PAY3, PAY4, and PAY5). PAY2 starts the pseudoconversation, and PAY5 ends it. Press Enter. The TRANGRP view is redisplayed.

  4. Create a workload definition.
    1. From the command line of the current view, issue the command WLMDEF. The WLMDEF view is displayed.
    2. From the WLMDEF view, issue the command CRE. The Create Workload Definition panel is displayed. Complete the panel as shown here:
     ----------------------- Create Workload Definition for PLXPROD1 ---------------
     COMMAND  ===>
     
      Definition Name      ===> WLDPAY03
      Description          ===> TRGPAY03 to the same target region
      Trangroup Name       ===> TRGPAY03       Specific Trangroup, Generic, or Blank
      Terminal Luname      ===> *              Specific or pattern Luname
      User Id              ===> *              Specific or pattern Userid
      Process Type         ===> *              Specific or pattern Process Type
      Target Scope         ===> CSGTGTS1       CICS System, Group, or Generic
     
    Press Enter to create definition.
    Type END or CANCEL to cancel without creating.
    These values tell CICSPlex SM that transactions in group TRGPAY03, initiated by any user and from any terminal, must go to a target region in group CSGTGTS1. CICSPlex SM can select the most appropriate target region at the time the transaction is initiated.

    Press Enter. The WLMDEF view is redisplayed.

    Note:
    For a complete description of the WLMDEF view, see WLMDEF (Workload definitions).
  5. Add the workload definition to the workload group.

    In the WLMDEF view, move the cursor to the entry for WLDPAY03, and issue ADD from the line-command field. The Add WLM Definition to Workload Group panel is displayed. In the Workload Group Name field, type WLGPAY01 and press Enter. The WLMDEF view is redisplayed.

  6. Install the new workload definition into the active workload.

    Because group WLGPAY01 is already associated with the active workload WLSPAY01, changes you make to that group will not take effect until the routing region CICSPT01, and the target regions in CICS system group CSGTGTS1, are next started. To make the new workload definition take effect immediately, you must install it explicitly in WLSPAY01.

    In the WLMDEF view, tab to the entry for WLDPAY03 again and issue INS from the line-command field. The Install WLMDEF panel is displayed. Complete the panel as shown here, and press Enter.

     ---------------------------- Install WLMDEF for PLXPROD1 ----------------------
     COMMAND  ===>
     
      Name            WLDPAY03
      Description     TRGPAY03 to the same target region
      Type            WLMDEF
     
      Workload ===> WLSPAY01 Active Workload in which to install the WLMDEF
                              Or Generic
      Owner    ===> *        Owner of the Workload in which to install the WLMDEF
                              Or Generic
     
     Press Enter to install Workload Definition.
     Type END or CANCEL to cancel without installing.

    The Owner value is the SYSID of the system on which the workload specification WLSPAY01 was created. If you enter a generic value in this field, CICSPlex SM presents a list from which you can select the correct value.

Because you have explicitly installed the workload definition WLDPAY03 in the active workload WLSPAY01, CICSPlex SM is able to honor this pseudoconversational transaction immediately. Be aware that you are able to use the single workload specification WLSPAY01 for both workload balancing and workload separation because you did not specify default Affinity Relation and Affinity Lifetime values in WLSPAY01. Had you done so, you would have had to create different workload specifications for workload balancing and workload separation.

Related concepts
Workload management and dynamic routing
Workload requirements
Establishing a workload
Balancing the work in a workload
Separating the work in a workload
Taking affinity relations into consideration
Related tasks
Balancing a workload
Adding a region to an existing target region scope
Removing a region from a target region scope
Adding a routing region to an active workload
Quiescing a target region in an active workload
Routing a specific transaction to a specific target region
Routing particular transactions from a given user to a specific target region
Deactivating a workload definition
Updating an active workload definition
Discarding an active transaction from a workload
Updating a workload specification
Using real-time analysis to select a target region for workload balancing
Related reference
WLMDEF (Workload definitions)
TRANGRP (Transaction groups)
[[ Contents Previous Page | Next Page Index ]]