Examples of managing records in the data repository

The following examples illustrate how you might create, remove, list, and dump definition records in the data repository, and add a CICS® system to a CICS system group.

Example 1 - Creating a record

To create a workload specification, you can use either the input panel, shown in Figure 9, which is produced when you issue the CREATE action command from the WLMSPEC view, or the batched repository-update facility.

Figure 9. Example of using a view to create a definition
 -------------------- Create WLM Specification for EYUPLX01 --------------------
 COMMAND  ===>
 
  WLM Spec Name       ===> EYUWMS01
  Description         ===> SSet - Basic Workload
 
  Affinity Relation   ===>              Default Affinity Relation
                                    (USERID, LUNAME, GLOBAL, BAPPL)
  Affinity Lifetime   ===>              Default Affinity Lifetime
                                        (SIGNON, LOGON, SYSTEM, PERMANENT,
                                        PCONV, DELIMIT, ACTIVITY, PROCESS)
  Match Key           ===> USERID       Default Primary search criterion
                                 (USERID,LUNAME)
  Create Affinity     ===>              Create Auto Affinity (YES, NO, N/A)
  Target Scope        ===> EYUCSG03     Default CICS System,Group or Generic
  Event Name          ===>              RTADEF, STATDEF, or Generic
 
  Abend Health        ===> 0            Target ABEND Health Factor (0 - 99)
  Abend Load          ===> 0            Target ABEND Load Factor (0 - 99)
  Algorithm Type      ===> Queue        Algorithm Type (GOAL, QUEUE)
 
 
Press Enter to create WLM Specification.
Type END or CANCEL to cancel without creating.

Figure 10 illustrates how to specify the same information when preparing a batched repository-update job:

Figure 10. Using the batched repository-update facility to create a definition
    /* after setting context, create workload specification */
    CONTEXT EYUPLX01;
    CREATE WLMSPEC NAME(EYUWMS01) DESC(Sample description)
                   AFFINITY(USERID)
                   AFFLIFE(SIGNON)
                   MATCH(USERID)
                   AORSCOPE(EYUCSG01)
                   EVENTNAME(PAGERATE)
                   ABENDCRIT(0)
                   ABENDTHRESH(0)
                   ALGTYPE(QUEUE);

Example 2 - Removing a record

To remove the workload specification named EYUWMS01, you might specify:

  CONTEXT EYUPLX01;
  REMOVE WLMSPEC NAME(EYUWMS01);

To remove the BAS PROGDEF named EYUPROG1, you might specify:

  CONTEXT EYUPLX01;
  REMOVE PROGDEF NAME(EYUPROG1)
                 DEFVER(1); 

Example 3 - Creating a link record

To create a link called WLMSPC01 between a workload specification and a CICS system group, you might specify:

  CREATE LNKSWSCG SPEC(WLMSPC01)
                  GROUP(EYUCSG01)
                  FORCE;

Example 4 - Listing records

To list all workload specification records that have names beginning with EYU, you would specify:

  CONTEXT EYUPLX01;
  LIST WLMSPEC NAME(EYU*);

Figure 11 illustrates the output format of records that you list from the data repository. Note that the output produced by the DUMP control statement is very similar; the major difference being that the word CREATE precedes the resource table name. If you use the OUTPUT command, the DUMP command will produce both a report, as illustrated in Figure 11, and a data set, which contains the CREATE commands in a form suitable for re-input to the CICSPlex® SM batched repository-update facility; see Example 6 - Dumping records as input to create new records.

Figure 11. Sample output produced when listing data repository definitions
      CICSPlex SM - Repository Process Report
 
  Input DSN:    CPSM.BATCH.SAMPLE                        Input Member: TEST
 
  CONTEXT EYUPLX01;
  LIST WLMSPEC NAME(EYU*);
  EYUXU0218I  CVMBBC Batch LIST request complete - Status(OK)
  Last Change:   9/06/93 21:18:25.85895
         WLMSPEC NAME(EYUWMS02)
                 DESC(Sample definition 1)
                 AFFINITY(USERID)
                 AFFLIFE(SIGNON)
                 MATCH(USERID)
                 AORSCOPE(EYUCSG01)
                 EVENTNAME(PAGERATE)
                 ABENDCRIT(0)
                 ABENDTHRESH(0)
                 ALGTYPE(GOAL)
                 ;
 
  Last Change:   8/14/93 15:27:05.34023
         WLMSPEC NAME(EYUWMS03)
                 DESC(Sample definition 2)
                 AFFINITY(GLOBAL)
                 AFFLIFE(PERMANENT)
                 MATCH(N/A)
                 AORSCOPE(EYUCSG01)
                 EVENTNAME( )
                 ABENDCRIT(0)
                 ABENDTHRESH(0)
                 ALGTYPE(N/A)
                 ;
 
Note:
In the EYUWMS03 record in Figure 11, EVENTNAME is an example of a keyword that has no value; MATCH and ALGTYPE are examples of keywords with a value of N/A.

Example 5 - Dumping records as a backup

To back up all of the workload management records in the data repository, you would specify:

  CONTEXT EYUPLX01;
  DUMP WLMSPEC  NAME(*);
  DUMP WLMGROUP NAME(*);
  DUMP WLMDEF   NAME(*);
  DUMP TRANGRP  NAME(*);
  DUMP DTRINGRP TRANGRP(*);
  DUMP WLMINGRP GROUP(*);
  DUMP WLMINSPC NAME(*);

Example 6 - Dumping records as input to create new records

To dump all versions of the CICS resource definitions in the correct order, directly to a data set that is to be resubmitted as input for creating new records, you would specify the following. The OUTPUT command causes all CREATE records to be written to data set EYUIR01.MYOUT1.

  OUTPUT DATASET DSNAME(EYUIR01.MYOUT1) INQUOTES(NO);
  CONTEXT EYUPLX01;
  DUMP CSYSDEF  NAME(*);
  DUMP CSYSGRP  GROUP(*);
  DUMP RESGROUP RESGROUP(*);
  DUMP RESDESC  RESDESC(*);
  DUMP RASGNDEF RESASSGN(*);
  DUMP RASINDSC RESDESC(*)
                RESASSGN(*);
  DUMP RESINDSC RESDESC(*)
                RESGROUP(*);
  DUMP CONNDEF  NAME(*);
  DUMP SESSDEF  NAME(*);
  DUMP xxxxDEF  NAME(*);
         .
         .
         .
  DUMP CONINGRP CONNGROUP(*)
                CONNNAME(*);
  DUMP SESINGRP SESSGROUP(*)
                SESSNAME(*);
  DUMP xxxINGRP xxxxGROUP(*)
                xxxxNAME(*);
         .
         .
         .
  DUMP SYSLINK  FROMCSYS(*)
                TOCSYS(*);

where:

See the CICSPlex System Manager Resource Tables Reference for all possible variants of xxxxDEF and xxxINGRP definitions.

Note:
The xxxxDEF and xxxINGRP resource tables also include version attributes, which enable you to process a specific version of the record. You can specify:

Example 7 - Adding a CICS system to a CICS system group

To add a CICS system to a CICS system group associated with a monitor specification, and to create the link between the CICS system and the monitor specification, you might specify:

  CONTEXT EYUPLX01;
  CREATE CSGLCGCS GROUP(EYUCSG01) CICSNAME(EYUMAS1A);
  CREATE LNKSMSCS SPEC(MONSPC01) SYSTEM(EYUMAS1A);

When used to create a CICS system to CICS system group link record (CSGLCGCS) with the system group already associated with a specification, the batched repository-update facility does not create a specification-to-CICS system link record (LNKSxSCS). To associate the CICS system with the specification, the LNKSxSCS record must be created explicitly.

[[ Contents Previous Page | Next Page Index ]]