BC1PFUPD Creates IEBUPDTE Control Statements

cedraft
BC1PFUPD creates IEBUPDTE control statements from an Element or differences between two members.This utility  lets you generate control statements from Element delta members; enables concurrent programming on the same module; and lets program updates be generated and distributed. The output created by this utility is standard IEBUPDTE control cards.
When editing programs using ISPF, verify the option NUMBER ON is in effect. The Element type should define columns 1-80 as the compare columns.
How to Generate Control Cards from an
Endevor
Element
This is a two-step process. The JCL in member BC1JFUP1, found in the iprfx.iqual.CSIQJCL library, lets you generate the following:
  1. In the first step, an
    Endevor
    Element is printed to a temporary file using the PRINT action in SCL,
    Endevor
    's Software Control Language. When specifying the PRINT action, name masking can be used to select more than one Element. Additionally, multiple PRINT requests can be included in this first step.
  2. In the second step, the IEBUPDTE Request Card Generator reads the file created by the first step and creates IEBUPDTE control cards. If option CHANGES was specified in Step 1 on the SCL request, then ./ UPDATE IEBUPDTE control cards are generated. If option BROWSE was specified in Step 1, then ./ ADD IEBUPDTE control cards are generated.
Certain statements within the sample JCL control the generation of IEBUPDTE control cards:
  • The DDname BSTIPT01 is where the SCL is specified.
  • The DDname C1PRINT specifies the output file created by Step 1. If a level is not specified, then the current level is printed. The DCB attributes for this file are LRECL=133, RECFM=FB.
  • The DDname C1CHGSI specifies the temporary file created by Step 1 as shown on the DDname C1PRINT.
  • Output created by the IEBUPDTE Request Card Generator is written to the DDname C1UPDTO. The DCB attributes associated with this file are LRECL=80, RECFM=FB.
  • The PARM accepted as input by the program BC1PFUDP specifies the position of the sequence number within the Element. Two parameters can specify the beginning position and length of the sequence numbers. PARM rules are as follows:
    • The first parameter, as shown in the JCL, is SEQBEG=. The default for SEQBEG is 73.
    • The second parameter is SEQLNG=. The default for SEQLNG is 7. Valid range for SEQLNG is 1-8.
    • If SEQBEG is coded, then SEQLNG must be specified.
    • The NAME= parameter must not be specified.
How to Generate Control Cards When Two Members Differ
This utility operates independently of
Endevor
.
The JCL in member BC1JFUP2, found in the iprfx.iqual.CSIQJCL library, you to generate the following:
  1. Two files, NDVRIN1 and NDVRIN2 are compared and the differences are written to a temporary file. NDVRIN1 and NDVRIN2 must be sequential files or partitioned datasets with a member name provided.
  2. The IEBUPDTE Request Card Generator reads the file created by the first step and creates ./ UPDATE IEBUPDTE control cards.
Certain statements within the sample JCL control the generation of IEBUPDTE control cards: These are as follows:
  • The DDname NDVRIPT is where the compare columns are specified. The parameters OUTPUT CHANGES and FORMAT IEBUPDTE must be specified as shown in the example.
  • The DDnames NDVRIN1 and NDVRIN2 specify the two files to be compared. (Refer to the utility BSTPCOMP for more information.)
  • The DDname NDVRPCH specifies the output file created by Step 1. The DCB attributes for this file are LRECL=88, RECFM=FB.
  • The DDname C1CHGSI specifies the temporary file created by Step 1 as shown on the DDname C1PRINT.
  • DDname C1UPDTO. The DCB attributes associated with this file are LRECL=80, RECFM=FB.
  • The PARM accepted as input by the program BC1PFUDP specifies the position of the sequence number within the Element, and the member name associated with the ./ UPDATE card. Three parameters can be specified. PARM rules are as follows:
    • The first parameter, as shown in the JCL, is SEQBEG=. The default for SEQBEG is 73 .
    • The second parameter is SEQLNG=. The default for SEQLNG is 7. Valid range for SEQLNG is 1-8.
    • If SEQBEG is coded, than SEQLNG must be specified.
    • The third parameter is NAME=. This parameter controls the member name generated on the ./ UPDATE control card. This parameter is required.
The return codes for NDVRIPT differ from BSTPCOMP as follows:
  • 4
    3000
  • 9
    3001
  • 10
    3002
  • 11
    3003
  • 12
    3005
  • 13
    3006
  • 0
    3007