Examples of accessing CICS® resources

Shown here are two examples of accessing CICS® resources.

Example 1: Searching and editing a CICS® Temporary Storage Queue

To search and edit a CICS® Temporary Storage Queue, follow these steps:

  1. From the Primary Option Menu panel, select option 2 (Edit) to display the Edit Entry panel.
  2. In the Data set/path name field, type "TS:" as shown in Figure 1.

    The "TS:" indicates to File Manager that you want to edit one or more Temporary Storage Queues from a CICS® application.

    Note: To edit CICS® Transient Data Queues, type "TD:"; to edit CICS® files, type "FI:".)
    Figure 1. Specifying CICS® temporary storage queues
      Process   Options   Help
    ────────────────────────────────────────────────────────────────────────────────
     File Manager                   Edit Entry Panel
    
     Input Partitioned, Sequential or VSAM Data Set, or HFS file:
        Data set/path name TS:                                             +
        Member . . . . .              Blank or pattern for member list
        Volume serial  .              If not cataloged
        Start position .                                 +
        Record limit . .              Record Sampling  
        Inplace edit . .                (Prevent inserts and deletes)
     Copybook or Template:
        Data set name . . . . .                                               
        Member  . . . . . . . .              Blank or pattern for member list
    
     Processing Options:
      Copybook/template   Start position type   Enter "/" to select option
      3  1. Above            1. Key                Edit template    Type (1,2,S)
         2. Previous         2. RBA                Include only selected records
         3. None             3. Record number      Binary mode, reclen      
         4. Create dynamic   4. Formatted key      Create audit trail
                                                   Use I/O exit
     Command ===>                                                                  
      F1=Help      F2=Split     F3=Exit      F4=Expand    F7=Backward  F8=Forward
      F9=Swap     F10=Actions  F12=Cancel
  3. Press Enter.

    When you specify the type of CICS® resource ("TS:", "TD:", or "FI:") on an entry panel, but without any further qualification, File Manager next displays the CICS® Applid Selection List panel which lists the available CICS® applications as shown in Figure 2.

    Figure 2. List of CICS® applications
      Process   Options   Help
    ────────────────────────────────────────────────────────────────────────────────
      File Manager           CICS Applid Selection list          Row 00001 of 00023
    
       Applid   Status   Description
       *        *        *                                          
       CICSDEV1 Active   Development system 1
       CICSDEV2 Active   Development system 2
       CICSTST1 Inactive Testing system 1
       CICSTST2 Inactive Testing system 2
       CICSTST3 Inactive Testing system 3
       CICSTST4 Active   Testing system 4
       CICSPRD1 Inactive Production system 1
    
    ⋮
    
     Command ===>                                                       Scroll PAGE
      F1=Help      F2=Split     F3=Exit      F4=CRetriev  F5=RFind     F7=Backward
      F8=Forward   F9=Swap     F10=Left     F11=Right    F12=Cancel
  4. Select the CICS® application you want by typing "S" in the entry field next to the relevant applid (in this case, applid CICSTST1) as shown in Figure 3.
    Figure 3. Selecting a CICS® application
      Process   Options   Help
    ────────────────────────────────────────────────────────────────────────────────
      File Manager           CICS Applid Selection list          Row 00001 of 00023
    
       Applid   Status   Description
       *        *        *                                          
       CICSDEV1 Active   Development system 1
       CICSDEV2 Active   Development system 2
     S CICSTST1 Inactive Testing system 1
       CICSTST2 Inactive Testing system 2
       CICSTST3 Inactive Testing system 3
       CICSTST4 Inactive Testing system 4
       CICSPRD1 Inactive Production system 1
    
    ⋮
    
     Command ===>                                                       Scroll PAGE
      F1=Help      F2=Split     F3=Exit      F4=CRetriev  F5=RFind     F7=Backward
      F8=Forward   F9=Swap     F10=Left     F11=Right    F12=Cancel
  5. Press Enter.

    File Manager then displays a list of Temporary Storage Queues (because you specified "TS:" on the Edit Entry Panel) for the selected CICS® application as shown in Figure 4.

    Figure 4. List of CICS® temporary storage queues
      Process   Options   Help
    ────────────────────────────────────────────────────────────────────────────────
      File Manager      CICS Temporary Storage Selection List    Row 00001 of 00005
    
       Queue            Loc   Items Size      Max   Min   Tran   Last     SYS   Po ±
       *                *                                 *               *     * 
       lowercase        AUX      20      6400   320   320 FM       97210
       KSDSXX           AUX      20      2560   128   128 FM       98913
       KSDS10           AUX      10      1280   128   128 FM       14654
       TDTD"'TDTD TD    AUX     100     32000   320   320 FM       97194
       TDTEST10         AUX      10      3200   320   320 FM       97423
     ****  End of data  ****
    
     ⋮
    
     Command ===>                                                       Scroll PAGE
      F1=Help      F2=Split     F3=Exit      F4=CRetriev  F5=RFind     F7=Backward
      F8=Forward   F9=Swap     F10=Left     F11=Right    F12=Cancel
  6. Select the Temporary Storage Queue you want by typing "S" in the entry field next to the relevant queue (in this case, KSDS10) as shown in Figure 5.
    Figure 5. Selecting a CICS® temporary storage queue
      Process   Options   Help
    ────────────────────────────────────────────────────────────────────────────────
      File Manager      CICS Temporary Storage Selection List    Row 00001 of 00005
    
       Queue            Loc   Items Size      Max   Min   Tran   Last     SYS   Po ±
       *                *                                 *               *     * 
       lowercase        AUX      20      6400   320   320 FM        97210
       KSDSXX           AUX      20      2560   128   128 FM        98913
     S KSDS10           AUX      10      1280   128   128 FM        14654
       TDTD"'TDTD TD    AUX     100     32000   320   320 FM        97194
       TDTEST10         AUX      10      3200   320   320 FM        97423
     ****  End of data  ****
    
     ⋮
    
     Command ===>                                                       Scroll PAGE
      F1=Help      F2=Split     F3=Exit      F4=CRetriev  F5=RFind     F7=Backward
      F8=Forward   F9=Swap     F10=Left     F11=Right    F12=Cancel
  7. Press Enter.

    File Manager then displays the data in the selected Temporary Storage Queue as shown in Figure 6.

    Figure 6. Data in CICS® temporary storage queue
      Process   Options   Help
    ────────────────────────────────────────────────────────────────────────────────
     Edit             TS:CICSTST1:KSDS10                               Top of 10
            Col 1       Insert Length 80              Record AT TOP     Format CHAR
            ----+----10---+----2----+----3----+----4----+----5----+----6----+----7--
     ****** ****  Top of data  ****
     000001 ....1       aaaaaaaaaaaaaaa                         6324West aindy    Wa
     000002 ....2       aaaaaaaaaaaaaaa                         6324West aindy    Wa
     000003 ....3       74 Redcliffe St                         6324West aindy    Wa
     000004 ....4       74 Redcliffe St                         6324West aindy    Wa
     000005 ....5       74 Redcliffe St                         6324West aindy    Wa
     000006 ....6       74 Redcliffe St                         6324West aindy    Wa
     000007 ....7       74 Redcliffe St                         6324West aindy    Wa
     000008 ....8       74 Redcliffe St                         6324West aindy    Wa
     000009 ....9       74 Redcliffe St                         6324West aindy    Wa
     000010 ....10      74 Redcliffe St                         6324West aindy    Wa
     ****** ****  End of data  ****
    
    ⋮
    

Example 2: Searching and modifying a CICS® file

To search and modify a CICS® file, follow these steps:

  1. From the Primary Option Menu panel, select option 2 (Edit) to display the Edit Entry panel.
  2. In the Data set/path name field, type "FI:CICSTST1" as shown in Figure 7.

    The "FI:" indicates to File Manager that you want to edit one or more CICS® files, and the "CICSTST1" indicates that you want to edit the files from the CICS® application, CICSTST1.

    Figure 7. Specifying CICS® files from a CICS® application
      Process   Options   Help
    ────────────────────────────────────────────────────────────────────────────────
     File Manager                   Edit Entry Panel
    
     Input Partitioned, Sequential or VSAM Data Set, or HFS file:
        Data set/path name FI:CICSTST1                                     +
        Member . . . . .              Blank or pattern for member list
        Volume serial  .              If not cataloged
        Start position .                                 +
        Record limit . .              Record Sampling  
        Inplace edit . .                (Prevent inserts and deletes)
     Copybook or Template:
        Data set name . . . . .                                               
        Member  . . . . . . . .              Blank or pattern for member list
    
     Processing Options:
      Copybook/template   Start position type   Enter "/" to select option
      3  1. Above            1. Key                Edit template    Type (1,2,S)
         2. Previous         2. RBA                Include only selected records
         3. None             3. Record number      Binary mode, reclen      
         4. Create dynamic   4. Formatted key      Create audit trail
                                                   Use I/O exit
     Command ===>                                                                  
      F1=Help      F2=Split     F3=Exit      F4=Expand    F7=Backward  F8=Forward
      F9=Swap     F10=Actions  F12=Cancel
  3. Press Enter.

    When you specify the type of CICS® resource ("TD:", "TS:", or "FI:") and the CICS® application on an entry panel, but without specifying the name of the CICS® resource, File Manager next displays a selection list of the Transient Data Queues, Temporary Storage Queues, or files for the specified CICS® application. In this case, File Manager displays a list of CICS® files for the specified CICS® application (CICSTST1) as shown in Figure 8.

    Figure 8. Selection list of CICS® files
      Process   Options   Help
    ────────────────────────────────────────────────────────────────────────────────
      File Manager            CICS File Selection List           Row 00001 of 00020
       File     Data Set Name                                Type O E R U A B D SY ±
       *        *                                            *    P N E P D R E * 
                                                                  E A A D D O L
    
       DFHCSD   CICS.FILE.DFHCSD                             KSDS O E R U A B D
       DFHDBFK                                               VSAM C E R U A B D
       DFHLRQ   CICS.FILE.DFHLRQ                             KSDS O E R U A B D
       ESDS10   CICS.FILE.ESDS                               KSDS O E R U   B  
       EZACACHE EZACACHE                                     TABL C U R U A B D
       EZACONFG CICS.FILE.EZACONFG                           KSDS C D R     B  
       FMDATA   CICS.FILE.FMDATA                             KSDS C E R        
       PMRRDS1  CICS.FILE.PMRRDS1                            KSDS C E R        
       RRDS10   CICS.FILE.RRDS10                             KSDS O E R U   B  
    
    ⋮
    
     ****  End of data  ****
    
     Command ===>                                                       Scroll PAGE
      F1=Help      F2=Split     F3=Exit      F4=CRetriev  F5=RFind     F7=Backward
      F8=Forward   F9=Swap     F10=Left     F11=Right    F12=Cancel
  4. You can now proceed to work with any of the CICS® resources listed.

    For more information about working with CICS® resources in File Manager, see File Manager for z/OS User’s Guide and Reference for CICS.