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.
Figure 61 shows an example job stream to run the DFHBARUP program. The job stream should include DD statements for the following data sets:
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.
//*******************************************************************
//* 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)
/*
//*
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'
The minimum abbreviation of this parameter is N. The possible values are:
The minimum abbreviation of this parameter is P.
The minimum abbreviation of this parameter is T. The minimum abbreviations of MIXEDCASE and UPPERCASE are M and U respectively.
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.
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.
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.
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).
.
.
//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.
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 *......................... *