Using DFHBARUP

Run DFHBARUP as a batch job.

DFHBARUP reads the records in the order they are stored on the repository--that is, in keyed-sequence order. To select the records that DFHBARUP writes to the output data set, SYSPRINT, you include control statements in the SYSIN data set. By default, DFHBARUP prints all records currently on the data set. DFHBARUP formats the selected records before writing them to SYSPRINT.

Sample job stream to run the DFHBARUP program

Figure 61 shows an example job stream to run the DFHBARUP program. The job stream should include DD statements for the following data sets:

The repository
The repository data set to be examined to produce the output data. (Figure 61 shows a DD name of 'REPOS'.)
STEPLIB
A partitioned data set (DSORG=PO) that contains the DFHBARUP program module. If the module is in a library in the link list, this statement is not required.
SYSIN
The input control data set. This file must be in 80-byte record format. The control statements that you can use in this data set are described in SYSIN control statements.

Control statements can be continued on to the next line by including any non-blank character in column 72. If the line that follows a continuation character is empty or contains control arguments which conflict with those that make up the preceding part of the control statement, an error is reported and execution of the utility ends. Any characters which occur beyond column 72 are ignored.

SYSPRINT
The output data set to which the formatted audit records and control messages are to be sent.

Figure 61. Sample job to run the DFHBARUP utility program. This job prints all the records for the ORDER activity of the CUSTSALES1999.13872977829728.QA process.
  //*******************************************************************
  //* RUN DFHBARUP (REPOSITORY UTILITY PROGRAM)
  //*
  //*
  //*******************************************************************
  //ARUP     EXEC PGM=DFHBARUP,PARM='N(EN),P(60),T(M)'
  //STEPLIB    DD DSN=CTS130.CICS530.SDFHLOAD,DISP=SHR
  //*******************************************************************
  //*   The output will go to SYSPRINT
  //*******************************************************************
  //SYSPRINT DD SYSOUT=A,DCB=RECFM=FBA
  //REPOS DD DISP=SHR,DSN=CICS530.CBTS.SALESREP
  //SYSIN    DD *
  PTYPE(SALES)                                                           +
  PROCESS(CUSTSALES1999.13872977829728.QA)                               +
  ACTIVITY(ORDER)
  /*
  //*

EXEC parameters

You can use the PARM keyword on the EXEC statement to pass one or more of the following parameters to the DFHBARUP utility. The form of the EXEC statement is:

EXEC PGM=DFHBARUP,PARM='parm1,...,parmn'
NATLANG({EN|CS|KA})
The language in which messages are to be issued.

The minimum abbreviation of this parameter is N. The possible values are:

CS
Traditional Chinese
EN
English. This is the default.
KA
Kanji.
PAGESIZE({60|nn})
The number of lines to be printed per page, when the output from the utility is sent to a printer. Valid values are in the range 20-99. The default is 60.

The minimum abbreviation of this parameter is P.

TRANSLATE({MIXEDCASE|UPPERCASE})
Whether the output from the utility is to be in mixed-case or uppercase. The default is mixed-case.

The minimum abbreviation of this parameter is T. The minimum abbreviations of MIXEDCASE and UPPERCASE are M and U respectively.

SYSIN control statements

The SYSIN data set is used to pass information to DFHBARUP. You can include statements to select specific sets of records to be formatted. Comments are identified by an asterisk in the first position. The SYSIN data set must be defined.

Format of the SYSIN control statements

   SYSIN DD *
   [REPOSITORY(name)]
   [PTYPE(name)]
   [PROCESS(name)]
   [ACTIVITY(name)]

The REPOSITORY statement cannot contain additional arguments. Other statements may consist of multiple arguments. When using multiple arguments, put each argument on a separate line; use a non-blank character in column 72 to indicate that this argument and the following one are to be treated as a single control statement. An illegal combination of arguments generates an error message and the utility is not run against the logstream.

ACTIVITY(name)
The 1-16 character name of an activity. Only records for activities of this name will be formatted. To limit the scope of the search, specify a PROCESS or PTYPE argument in conjunction with ACTIVITY.
PROCESS(name)
The 1-36 character name of a BTS process. No further arguments are needed to make up a control statement; if none are provided, all records containing this process name are selected. To limit the scope of the search, you can add a PTYPE argument on an adjoining line, using a continuation character in column 72.
PTYPE(name)
The 1-8 character name of a BTS process-type. No additional arguments are needed; if none are provided, all records containing this process-type are selected. To limit the scope of the search, you can add a PROCESS argument on an adjoining line, using a continuation character in column 72.
REPOSITORY(name)
The 1-8 character DD name that identifies the repository data set to be searched. The default is 'REPOS'. This argument must not be specified more than once. It cannot be used with any other in a control statement.

If the specified repository file cannot be opened, or if more than one REPOSITORY statement is found in the SYSIN data set, an error occurs and DFHBARUP terminates.

Example output from the DFHBARUP utility

The example control statements in Figure 62 would format all the records currently on the SALEREP repository for the SALES1234567890 process (which is of the SALES process-type).

Figure 62. Example control statements, to format all records on the SALEREP repository for the SALES1234567890 process
  .
  .
  //SALESREP DD DISP=SHR,DSN=CICS530.CBTS.SALESREP
  //SYSIN      DD *
  REPOSITORY(SALESREP)
  PTYPE(SALES)                                                           +
  PROCESS(SALES1234567890)
  /*
 

Figure 63 shows the output that might be produced by the control statements in Figure 62.

Figure 63. Example output from the DFHBARUP utility
CICS Business Transaction Services - Parameter Validation                               Date : 29/01/1999 Time : 14:39:04 Page 0001
Exec Parm Options: Natlang   (EN)
                   Translate (mixedcase)
                   Pagesize  (60)
 
REPOSITORY(SALEREP)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
CICS Business Transaction Services - Repository File Report                             Date : 29/01/1999 Time : 14:39:04 Page 0002
Activity Name : DFHROOT          Id : ..GBIBMIYA.IYCWTC37........DFHROOT           Generation : 0000001
                                      11CCCCDCEC4CECEECFF44042F00CCCDDDE4444444444
                                      A172924981B98363337BB0C1B0146896630000000000
Definitional Attributes
  Program    : ABU081D
  Transid    : RUP4
  Userid     : CICSUSER
  Comp Event :
Current State
  Mode        : Dormant    (Initial, Active, Dormant, Cancelling, Complete)
  Suspended   : No  (Yes, No)
  Generation  : 0000001
  Child Count : 0000002
Completion Status
  Completion Response : Incomplete
 
000000   C1401A11 C7C2C9C2 D4C9E8C1 4BC9E8C3 E6E3C3F3 F74B4B00 4C21FB00 01C4C6C8  *A ..GBIBMIYA.IYCWTC37...<....DFH*
000020   D9D6D6E3 40404040 40404040 40400000 00000004 00004000 000005E0 01500000  *ROOT          ........ ....\.&..*
000040   6EC4C6C8 C2C1C1C3 E3C9E5C9 00000000 FFFFFFFF 01500001 00000000 D740D7E3  *>DFHBAACTIVI.........&......P SA*
000060   E8D7C5F1 4040D7D9 D6C36DC6 D6E4D940 40404040 40404040 40404040 40404040  *LES   SALES1234567890           *
000080   40404040 40404040 40400000 00000000 00000000 00000000 00000000 00000000  *          ......................*
0000A0   00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000  *................................*
0000C0   1A11C7C2 C9C2D4C9 E8C14BC9 E8C3E6E3 C3F3F74B 4B004C21 FB000103 00000000  *..GBIBMIYA.IYCWTC37...<.........*
0000E0   00000000 00000000 00000000 00000000 00000002 00000000 00000000 000003C4  *...............................D*
000100   00000001 00000000 00000000 00000000 00000000 00000000 00000000 00000000  *................................*
000120   00000000 10C2011C 10C2011C 00000000 00000000 10C2012C 10C2012C C1C2E4F0  *.....B...B...........B...B..ABU0*
000140   F8F1C440 00000000 00000000 D9E4D7F4 C3C9C3E2 E4E2C5D9 40404040 40404040  *81D ........RUP4CICSUSER        *
000160   40404040 40404040 01404040 40404040 40404040 4003C2C1 D4C1E4C4 C9E30000  *        .            .BAMAUDIT..*
000180   00000000 0000FFFF FFFFFFFF                                               *............                    *
Related BTS Objects
  Process Type : SALES   Name : SALES1234567890
  No Parent
  Child Name : ACT_3            Id : ..GBIBMIYA.IYK2ZFX2........ACT_3             Generation : 0000001
                                     11CCCCDCEC4CEDFECEF440F3A00CCE6F444444444444
                                     A172924981B98229672BBCF9F01133D3000000000000
  Child Name : ACT_ONE          Id : ..GBIBMIYA.IYK2ZFX2........ACT_ONE           Generation : 0000001
                                     11CCCCDCEC4CEDFECEF44068A00CCE6DDC4444444444
                                     A172924981B98229672BBB35A01133D6550000000000
Eventpool
  Event : (Reattach)
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
CICS Business Transaction Services - Repository File Report                             Date : 29/01/1999 Time : 14:39:04 Page 0003
  Event : DFHINITIAL
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
  Event : ACT_ONE
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
  Event : ACT_3
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
 
Containers
 
  No Containers
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
CICS Business Transaction Services - Repository File Report                             Date : 29/01/1999 Time : 14:39:04 Page 0004
Activity Name : ACT_ONE          Id : ..GBIBMIYA.IYK2ZFX2........ACT_ONE           Generation : 0000001
                                      11CCCCDCEC4CEDFECEF44068A00CCE6DDC4444444444
                                      A172924981B98229672BBB35A01133D6550000000000
Definitional Attributes
  Program    : ABU081E
  Transid    : RUP5
  Userid     : CICSUSER
  Comp Event : ACT_ONE
Current State
  Mode        : Dormant    (Initial, Active, Dormant, Cancelling, Complete)
  Suspended   : No  (Yes, No)
  Generation  : 0000001
  Child Count : 0000000
Completion Status
  Completion Response : Incomplete
 
000000   C1401A11 C7C2C9C2 D4C9E8C1 4BC9E8D2 F2E9C6E7 F24B4B0B 6385AA00 01C1C3E3  *A ..GBIBMIYA.IYK2ZFX2....e...ACT*
000020   6DD6D5C5 40404040 40404040 40400000 00008081 00004000 00003E88 01500000  *_ONE          .....a.. ....h.&..*
000040   6EC4C6C8 C2C1C1C3 E3C9E5C9 00000000 FFFFFFFF 01500001 00000000 D740D7E3  *>DFHBAACTIVI.........&......P SA*
000060   E8D7C5F1 4040D7D9 D6C36DC6 D6E4D940 40404040 40404040 40404040 40404040  *LES   SALES1234567890           *
000080   40404040 40404040 40400000 0000C140 1A11C7C2 C9C2D4C9 E8C14BC9 E8C3E6E3  *          ....A ..GBIBMIYA.IYCWT*
0000A0   C3F3F74B 4B004C21 FB0001C4 C6C8D9D6 D6E34040 40404040 40404040 00000000  *C37...<....DFHROOT          ....*
0000C0   1A11C7C2 C9C2D4C9 E8C14BC9 E8C3E6E3 C3F3F74B 4B004C21 FB000103 D9E4D7F4  *..GBIBMIYA.IYCWTC37...<.....RUP4*
0000E0   C3C9C3E2 E4E2C5D9 00000000 00000001 00000000 00000000 00000000 000003C4  *CICSUSER.......................D*
000100   00000001 00000003 000084A9 00000000 00000000 00000000 00000000 00000000  *..........dz....................*
000120   00000000 108F911C 108F911C 00000000 00000000 10C20C10 101465E0 C1C2E4F0  *......j...j..........B.....\ABU0*
000140   F8F1C540 00000000 00000000 D9E4D7F5 C3C9C3E2 E4E2C5D9 C1C3E36D D6D5C540  *81E ........RUP5CICSUSERACT_ONE *
000160   40404040 40404040 01404040 40404040 40404040 4003C2C1 D4C1E4C4 C9E30000  *        .            .BAMAUDIT..*
000180   00000000 0000FFFF FFFFFFFF                                               *............                    *
Related BTS Objects
  Process Type : SALES   Name : SALES1234567890
  Parent Name : DFHROOT          Id : ..GBIBMIYA.IYCWTC37........DFHROOT           Generation : 0000001
                                      11CCCCDCEC4CECEECFF44042F00CCCDDDE4444444444
                                      A172924981B98363337BB0C1B0146896630000000000
No Children
Eventpool
  Event : (Reattach)
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
CICS Business Transaction Services - Repository File Report                             Date : 29/01/1999 Time : 14:39:04 Page 0005
  Event : DFHINITIAL
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
  Event : ACT1_CONTINUE
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
  Event : ACT1_END
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
  Event : ACT2_DEF
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
  Event : ACT2_CAN
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
  Event : ACT2_SUS
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
  Event : ACT2_RES
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
 
Containers
 
Container Name : ACT_CONT_1      Container Length : x'00008000'
 
000000   FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF  *................................*
   .
   lines omitted
   .
07FE0   FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF  *................................*
Container Name : ACT_CONT_2      Container Length : x'00000400'
 
000000   22222222 22222222 22222222 22222222 22222222 22222222 22222222 22222222  *................................*
   .
   lines omitted
0003E0   22222222 22222222 22222222 22222222 22222222 22222222 22222222 22222222  *................................*
Container Name : ACT_CONT_3      Container Length : x'00000019'
 
000000   10101010 10101010 10101010 10101010 10101010 10101010 10                 *.........................       *
CICS Business Transaction Services - Repository File Report                             Date : 29/01/1999 Time : 14:39:04 Page 0006
Activity Name : ACT_3            Id : ..GBIBMIYA.IYK2ZFX2........ACT_3             Generation : 0000001
                                      11CCCCDCEC4CEDFECEF440F3A00CCE6F444444444444
                                      A172924981B98229672BBCF9F01133D3000000000000
Definitional Attributes
  Program    : ABU081Z
  Transid    : RUPZ
  Userid     : CICSUSER
  Comp Event : ACT_3
Current State
  Mode        : Dormant    (Initial, Active, Dormant, Cancelling, Complete)
  Suspended   : No  (Yes, No)
  Generation  : 0000001
  Child Count : 0000000
Completion Status
  Completion Response : Incomplete
 
000000   C1401A11 C7C2C9C2 D4C9E8C1 4BC9E8D2 F2E9C6E7 F24B4B0C FF39AF00 01C1C3E3  *A ..GBIBMIYA.IYK2ZFX2........ACT*
000020   6DF34040 40404040 40404040 40400000 00000000 00004000 00000550 01500000  *_3            ........ ....&.&..*
000040   6EC4C6C8 C2C1C1C3 E3C9E5C9 00000000 D9D4E4E6 01500001 00000000 D740D7E3  *>DFHBAACTIVI....RMUW.&......P SA*
000060   E8D7C5F1 4040D7D9 D6C36DC6 D6E4D940 40404040 40404040 40404040 40404040  *LES   SALES1234567890           *
000080   40404040 40404040 40400000 0000C140 1A11C7C2 C9C2D4C9 E8C14BC9 E8C3E6E3  *          ....A ..GBIBMIYA.IYCWT*
0000A0   C3F3F74B 4B004C21 FB0001C4 C6C8D9D6 D6E34040 40404040 40404040 00000000  *C37...<....DFHROOT          ....*
0000C0   1A11C7C2 C9C2D4C9 E8C14BC9 E8C3E6E3 C3F3F74B 4B004C21 FB000103 D9E4D7F4  *..GBIBMIYA.IYCWTC37...<.....RUP4*
0000E0   C3C9C3E2 E4E2C5D9 00000000 00000001 00000000 00000000 00000000 000003C4  *CICSUSER.......................D*
000100   00000001 00000000 00000000 00000000 00000000 00000000 00000000 00000000  *................................*
000120   00000000 10C2911C 10C2911C 00000000 00000000 10C2912C 10C2912C C1C2E4F0  *.....Bj..Bj..........Bj..Bj.ABU0*
000140   F8F1E940 00000000 00000000 D9E4D7E9 C3C9C3E2 E4E2C5D9 C1C3E36D F3404040  *81Z ........RUPZCICSUSERACT_3   *
000160   40404040 40404040 01404040 40404040 40404040 4003C2C1 D4C1E4C4 C9E30000  *        .            .BAMAUDIT..*
000180   00000000 00000000 00000000                                               *............                    *
Related BTS Objects
  Process Type : SALES   Name : SALES1234567890
  Parent Name : DFHROOT          Id : ..GBIBMIYA.IYCWTC37........DFHROOT           Generation : 0000001
                                      11CCCCDCEC4CECEECFF44042F00CCCDDDE4444444444
                                      A172924981B98363337BB0C1B0146896630000000000
No Children
Eventpool
  Event : (Reattach)
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
CICS Business Transaction Services - Repository File Report                             Date : 29/01/1999 Time : 14:39:04 Page 0007
  Event : DFHINITIAL
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
  Event : T1
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
    Timer     : TIMER_ONE
  Event : T2
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
    Timer     : TIMER_TWO
  Event : T3
    Type      : Activity
    Fired     : No
    Reattach  : Yes
    Retrieve  : No
    Subevent  : No
    Timer     : TIMER_3
  Timer : TIMER_ONE
    Status    : Unexpired
    Date      : 05/11/1998 Time : 10:23:46
    Event     : T1
  Timer : TIMER_TWO
    Status    : Unexpired
    Date      : 08/11/1998 Time : 10:23:49
    Event     : T2
  Timer : TIMER_3
    Status    : Unexpired
    Date      : 27/11/1998 Time : 10:23:52
    Event     : T3
 
Containers
 
  No Containers
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
CICS Business Transaction Services - Repository File Report                             Date : 29/01/1999 Time : 14:39:04 Page 0008
Process : SALES1234567890                             Process Type : SALES
Root Id : ..GBIBMIYA.IYCWTC37........DFHROOT
          11CCCCDCEC4CECEECFF44042F00CCCDDDE4444444444
          A172924981B98363337BB0C1B0146896630000000000
Audit Level : Full (Off, Pro, Act, Full)
Audit Log   : BAMAUDIT
000000   D740D7E3 E8D7C5F1 4040D7D9 D6C36DC6 D6E4D940 40404040 40404040 40404040  *P SALES   SALES1234567890       *
000020   40404040 40404040 40404040 40400000 00008004 00004000 00003E14 00A00000  *              ........ .........*
000040   6EC4C6C8 C2C1D7D9 D6C3C5E2 00000000 00000000 00000000 00000000 C1401A11  *>DFHBAPROCES................A ..*
000060   C7C2C9C2 D4C9E8C1 4BC9E8C3 E6E3C3F3 F74B4B00 4C21FB00 01C4C6C8 D9D6D6E3  *GBIBMIYA.IYCWTC37...<....DFHROOT*
000080   40404040 40404040 40400000 0000776F 10C2003C 00000003 000084A9 00000000  *          .....?.B........dz....*
0000A0   00000000 00000000 00000000 00000000 00000000 108F90AC 108F90AC 00000000  *................................*
0000C0   00000000 10146C90 10146710 03C2C1D4 C1E4C4C9 E3000001 00000000           *......%......BAMAUDIT.......    *
Containers
Container Name : Container_one   Container Length : x'00008000'
 
000000   FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF  *................................*
       
·
·
·
lines omitted
·
·
·
007FE0 FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF *................................*
CICS Business Transaction Services - Repository File Report                             Date : 29/01/1999 Time : 14:39:04 Page 0009
Container Name : Container_two   Container Length : x'00000400'
 
000000   22222222 22222222 22222222 22222222 22222222 22222222 22222222 22222222  *................................*
       
·
·
·
lines omitted
·
·
·
0003E0 22222222 22222222 22222222 22222222 22222222 22222222 22222222 22222222 *................................* Container Name : Container_three Container Length : x'00000019' 000000 10101010 10101010 10101010 10101010 10101010 10101010 10 *......................... *

Note:
A DFHBARUP report shows activity identifiers in the form they are stored on the repository. Unlike the activity identifiers returned by commands such as ASSIGN and GETNEXT ACTIVITY, those shown by DFHBARUP are not prefixed with the CICS® file name of the repository.

Related concepts
Introduction to the repository utility program, DFHBARUP
Recovery and restart in BTS
Related tasks
Defining BTS data sets
Defining repository files to the CSD
[[ Contents Previous Page | Next Page Index ]]