Start of change

Defining resources for an application

This example uses the Web User Interface (WUI) to create the resource definitions that are required for a Workload Manager (WLM) application. The example describes the use of resource assignments and uses the Fully functional Business Application Services (BAS) administration views menu aimed at more advanced CICSPlex® SM users. This application is illustrated in the first CICSPlex SM installation verification procedure (IVP1), as described in the CICS® Transaction Server for z/OS® Installation Guide.

  1. Create a resource group definition.
    1. From the WUI main menu, click Administration views-->Fully functional Business Application Services (BAS) administration views-->CICS resource definitions-->Resource groups 6 to open the Resource group definition tabular view.
    2. If the current context is not EYUPLX01, specify EYUPLX01 in the Context field and click Refresh.
    3. Click the Create action button and complete the Create panel as follows:
      Resource group name
      EYUBAG01
      Description
      SSET -- WLM IVP application
      Mode value
      NO
      Other fields can remain blank.
    4. Click Yes to confirm. The Resource group definition tabular view is redisplayed.

    At this point, group EYUBAG01 exists, but is empty. The next step is to create the resource definitions that constitute the WLM application and add them to the group.

  2. Create the transaction definition.
    1. From the WUI main menu, click Administration views-->Fully functional Business Application Services (BAS) administration views-->CICS resource definitions-->Transaction definitions to open the Transaction definition tabular view.
    2. Click the Create action button and complete the Create panel as follows:
      Transaction definition name
      ETVP
      Definition version
      0
      Description
      SSET -- Workload IVP application
      Resource group name
      EYUBAG01
      First program name
      EYUWLMVP
      Size in bytes of transaction work area
      0
      Transaction profile
      DFHCICST
      Enabled status
      Enabled
      Task data location
      Below
      Task data key
      User
      Storage clearance status
      No
      Runaway timeout value
      SYSTEM
      Shutdown run status
      Disabled
      Transaction isolation option
      Yes
      Dynamic routing option
      Yes
      Dynamic routing status
      Yes
      Remote system name
      1A3A
      Remote transaction name
      ETVP
      Transaction routing profile
      DFHCICSS
      Queuing on local system
      N_a
      Transaction priority
      1
      Transaction class number
      1
      Transaction class name
      DFHTCL00
      CICS failure action
      Backout
      In-doubt wait option
      Yes
      In-doubt wait time (days, hours and minutes)
      0
      In-doubt failure processing action
      Backout
      Resource security checking
      No
      Command level security option
      No
      Other fields can remain blank.
    3. Click Yes to confirm. The Transaction definition tabular view is redisplayed.
  3. Create the program definition.
    1. From the WUI main menu, click Administration views-->Fully functional Business Application Services (BAS) administration views-->CICS resource definition views-->Program definitions to open the Program definition tabular view.
    2. Click the Create action button and complete the Create panel as follows:
      Program definition name
      EYUWLMVP
      Definition version
      0
      Definition description
      SSET -- Workload IVP definition
      Resource group name
      EYUBAG01
      Language
      Assembler
      Reload new copy
      No
      Residence status
      No
      Program storage release
      Normal
      Use program from the link pack area (LPA)
      No
      Enabled status
      Enabled
      Resource security value
      0
      Display execution diagnostic facility (EDF) screens
      Yes
      Data location
      Below
      Program execution key
      User
      Concurrency status
      Quasirent
      Dynamic routing status
      No
      API subset restriction type
      Fullapi
      Java virtual machine (JVM) profile
      DFHJVMPR
      Hot pooling status
      No
      Other fields can remain blank.
    3. Click Yes to confirm. The Program Definition tabular view is redisplayed.
  4. Create the first file definition.
    1. From the WUI main menu, click Administration views-->Fully functional Business Application Services (BAS) administration views-->CICS resource definitions-->File definitions to open the File definition tabular view.
    2. Click the Create action button and complete the Create panel as follows:
      File definition name
      EYUFIL01
      Definition version
      0
      Definition description
      Payroll updates -- Local
      Data set name
      PAYROLL.EUTL3
      Record level sharing (RLS) file access mode
      No
      Local shared resources pool ID
      1
      Default level of read integrity
      Uncommitted
      VSAM data set name sharing
      Allreqs
      Maximum concurrent requests against file
      30
      Initial status
      Enabled
      File open time
      Firstref
      Disposition of file
      Share
      Number of data buffers
      31
      Number of index buffers
      30
      Data table type
      No
      Maximum number of records in data table
      NOLIMIT
      Table name
      IANSFILE
      Update model
      Locking
      Load type
      No
      Record format
      Variable
      Operations (Add, browse, delete, read, update)
      Yes (for all)
      Read operations recorded on journal
      None
      Synchronous auto journalling for input
      No
      Rewrite/delete operations recorded on journal
      No
      Add operations recorded on journal
      No
      Synchronous auto journalling for output
      No
      Type of recovery
      None
      CICS VSAM file backup type
      Static
      Other fields can remain blank.
    3. Click Yes to confirm the file creation. The file definition for EYUFIL01 is created and the File definition tabular view is redisplayed.
  5. Reuse the existing file definition to create a definition for another file.
    1. In the File definition tabular view, select the entry for EYUFIL01 and click the Create action button.

      The Create File Definition panel is displayed, showing the values you entered when creating EYUFIL01.

    2. Update the following fields:
      • Change File definition name to EYUFIL02
      • Make the following fields blank:
        • Local shared resources pool ID
        • Maximum concurrent requests against file
        • Number of data buffers
        • Number of index buffers
    3. Click Yes. The file definition for EYUFIL02 is created and the File definition tabular view is redisplayed.

    All of the resource definitions for the WLM application have now been created. The next step is to assign those resources to the appropriate CICS systems.

  6. Create a resource assignment for the transaction definition.
    1. From the WUI main menu, click Administration views-->Fully functional Business Application Services (BAS) administration views-->Resource assignments to open the Resource assignment definition tabular view.
    2. Click the Create action button to open a Resource assignment definition Create screen like the one shown in Figure 30.

      Complete the Create panel as follows:

      Resource assignment definition name
      EYUBAA01
      Description
      SSET -- Assign transaction definitions
      Resource group name
      EYUBAG01
      Type of resource to be processed by assignment
      TRANDEF
      Resource usage type
      Remote
      Resource usage qualifier
      Dynam
      Target scope name
      EYUMAS1A
      Related scope name
      EYUMAS1B
      Scope that override is applied to
      Related
      Other fields can remain blank.
    3. Click Yes. The resource assignment for transaction definitions is created and the Resource assignment definition tabular view is redisplayed.
    Note:
    This example does not make use of filter and override expressions for the assignment.
  7. Create a resource assignment for the program definition.
    1. In the Resource assignment definition tabular view, click the Create action button and complete the Create panel as follows:
      Resource assignment definition name
      EYUBAA02
      Description
      SSET -- Assign program definitions
      Target scope name
      EYUCSG03
      Resource group name
      EYUBAG01
      Type of resource to be processed by assignment
      PROGDEF
      Resource usage type
      Local
      Resource usage qualifier
      N_a
      Scope that override is applied to
      Related
      Other fields can remain blank.
    2. Click Yes. The resource assignment for program definitions is created and the Resource assignment definition tabular view is redisplayed.
  8. Create a resource assignment for the file definitions.
    1. In the Resource assignment definition tabular view, click the Create action button and complete the Create panel as follows:
      Resource assignment definition name
      EYUBAA03
      Description
      SSET -- Assign file definitions
      Target scope name
      EYUCSG03
      Related scope name
      EYUMAS4A
      Resource group name
      EYUBAG01
      Type of resource to be processed by assignment
      FILEDEF
      Resource usage type
      Remote
      Resource usage qualifier
      N_a
      Scope that override is applied to
      Related
      Other fields can remain blank.
    2. Click Yes. The resource assignment for file definitions is created and the Resource assignment definition tabular view is redisplayed.
    All of the resource assignments for the resource definitions have now been created. The next step is to group all of the resources together and identify them as an application.
  9. Create a resource description for the WLM application.
    1. From the WUI main menu, click Administration views-->Fully functional Business Application Services (BAS) administration views-->Resource descriptions to open the Resource description definition tabular view.
    2. Click the Create action button and complete the Create panel as follows:
      Resource description name
      EYUBAD01
      Description
      SSET -- WLM IVP Application
      Logical scope registration
      Yes
      Logical scope name
      WLMIVP
      Autoinstall request type
      Yes
      Other fields can remain blank.
    3. Click Yes. The resource description for the WLMIVP application is created and the Resource description definition tabular view is redisplayed.
    Note:
    This example does not make use of the fields relating to resource groups and the target and related scopes to which they apply. You already provided this information in the resource assignments you created.
  10. Associate the resource assignment for each resource type with the WLMIVP resource description.
    1. From the WUI main menu, click Administration views-->Fully functional Business Application Services (BAS) administration views-->Resource assignments to open the Resource assignment definition tabular view.
    2. Select the entry for EYUBAA01 (the resource assignment for transaction definitions) and click the Add to Resource description button. Complete the Add to Resource description panel as follows:
      Description name
      EYUBAD01
      Description
      Trans Assigned to WLMIVP
      Other fields can remain blank.
    3. Click Yes. The association between EYUBAA01 and EYUBAD01 is created and the Resource assignment definition tabular view is redisplayed.
    Repeat this step for resource assignments EYUBAA02 and EYUBAA03.
  11. Modify the CICS system definitions to indicate that automatic resource installation is required each time the target systems are cold started.
    1. From the WUI main menu, click Administration views-->Topology administration views-->CICS system definitions to open the CICS system definition tabular view.
    2. Select the entry for the CICS system EYUMAS1A. and click the Update button.
    3. Locate the Business Application Services section of the panel and update the fields as follows:
      Install BAS resources option
      Coldonly
      BAS install failure action
      Continue
    4. Click Yes. The CICS system definition is updated and the CICS system definition tabular view is redisplayed.
    Repeat this step for other CICS systems in the target scope.

Related tasks
Establishing CICSplex connectivity
Installing CICS resources dynamically
End of change
6.
You can also access this view from the Fully functional Business Application Services (BAS) administration views menu.

[[ Contents Previous Page | Next Page Index ]]