com.ibm.pdp.maf.rpp.pac.program

Interface CDLine

  • All Superinterfaces:
    Element
    All Known Subinterfaces:
    CDLineDataStructure, CDLineReport


    public interface CDLine
    extends Element

    The purpose of the CDLine is to identify the external resources of a Program.

    You can have resources represented by Data Structure or by Report.

    Some infomations are common to the both type of CDLine like :

    • the access mode,

    • the organization

    • the input ouptut mode,

    • the usage

    • the external name

    • Method Detail

      • getAccessKeyDataElementCode

        java.lang.String getAccessKeyDataElementCode()

        This code, on six characters, is required for indexed Data Structures.

        Returns:
      • getAccessMode

        ProgramAccesModeValues getAccessMode()

        Indicates the way the Data Structure is accessed by the Program

        Returns:
      • getBlockFactor

        int getBlockFactor()
        Returns:
      • getBlockMode

        ProgramBlockModeValues getBlockMode()

        This field generates the RECORDING MODE IS clause, which indicates the nature of the logical records of the file.

        Returns:
      • getCobolRecordLevel

        ProgramCobolRecordLevelValues getCobolRecordLevel()

        This option is used with the Generated description type field.

        It defines the COBOL level number for the descriptions of Data Structures, Segments and Data Elements.

        Returns:
      • getCodeInProgram

        java.lang.String getCodeInProgram()
        Returns:
      • getExternalName

        java.lang.String getExternalName()

        This field is optional, on six characters maximum. Its contents vary according to the Data Structure type and organization.

        For the Y: Pacbench C/S organization, this field must contain the code of the COBOL COPY clause which represents the communication area of the Pacbench C/S Application Component which accesses the Logical View.

        For an SQL database Data Structure, this field must contain the code of the SQL Block.

        For any other Data Structure, the contents of this field depend on the value of the Type of COBOL code in the Program Definition tab :

        • 1: IBM DOS/VSE This field can take 3 forms:

          • SYSnnn: symbolic unit name

          • XXXnnn symbolic unit name SYSnnn and external name of the XXX file

          • XXXXXX external name: The symbolic unit is generated with SYSnnn. nnn is incremented by one for each Data Structure starting with SYS010.

        • X: IBM MVS/ESA OS/390 The ASSIGN clause (for sequential files, S: sequential organization), with SYSnnn as external name, is generated in the following form: SYSnnn-UT-....-S-SYSnnn. For OS/390: DDNAME

        • 4: BULL GCOS7 INTERNAL-FILE-NAME

        • 5: BULL GCOS8 File-code (2 characters)

        • F: TANDEM External name

        • I: DEC/VAX VMS External name

        Returns:
      • getFormatType

        ProgramFormatTypeValues getFormatType()

        It is format of the Data Elements called in the Segments of the Data Structure.

        You must select the format according to the usage of the Data Structure. This field does not apply to the Data Structures whose usage is I: Direct printing or J: Indirect printing.

        Note: The Data Elements making up the Segments must not exceed 999 characters.

        Returns:
      • getGeneratedDescriptionType

        ProgramGeneratedDescriptionTypeValues getGeneratedDescriptionType()

        It is the type of record description to be used in the COBOL program to allow different uses of the Segment description stored in the Library.

        Returns:
      • getIOMode

        ProgramIOModeValues getIOMode()

        Indicates the opening mode of the Data Structure.

        In the external view, it determines whether the Data Structure will be inserted in the top part (for an input opening mode) or bottom part (for an output opening mode) of the view.

        Returns:
      • getOrganization

        ProgramOrganizationValues getOrganization()

        Give the organization of the DataStructure or The Report, whether the Data Structure must be generated in the WORKING-STORAGE SECTION, or as the description of a Pactables Table.

        This field is also used to specify database descriptions when the Database Description function is not used. These values are taken into account by application Programs.

        Returns:
      • getPhysicalUnitType

        java.lang.String getPhysicalUnitType()

        The possible unit type varies according to the Type of COBOL code:

        • Type of COBOL code = 1: IBM DOS/VSE: Enter the model type (examples: 2314, 3330, 2400)

        • Type of COBOL code = 3: UNIX, WINDOWS:

          • EXT = Generation of the EXTERNAL clause at the file FD level

          • LS = Generation of the LINE SEQUENTIAL clause

          • EXLS = Generation of the LINE SEQUENTIAL clause and of the EXTERNAL clause at the file FD level

        • Type of COBOL code = Q: ACUCOBOL:

          • LS = Generation of the LINE SEQUENTIAL clause

        • Type of COBOL code = 4: BULL GCOS7:

          • SSF = Option WITH SSF in the SELECT clause

          • OUT = Option -SYSOUT suffix after the file name in the SELECT clause (WITH SSF is generated).

        • Type of COBOL code = 5: BULL GCOS8:

          • PT = printer

          • CR = card reader

          • SSF = ORGANIZATION IS GFRC SEQUENTIAL SSF CODE SET IS GBCD

          • IBM = ORGANIZATION IS IBM-OS SEQUENTIAL

          • xxx = WITH xxx

        A V in the fourth position generates the clause VALUE OF FILE-ID is 3-FF00-IDENT (FF is the Data Structure Code in program). The field 3-FF00-IDENT must be defined in work areas by the user.

        • Type of COBOL code = 8: UNYSIS A Series:

          • DK or blank = disk

          • DKS = sort disk (with T opening).

          • DKM = merge disk (with T opening).

          • RD = reader.

          • PT = printer.

          • PO = file.

          • TP = tape.

        For the two-character codes, a third character can specify a particular final disposition:

          • P = purge

          • R = release

          • L = lock

          • S = save

        A V in the fourth position generates the clause VALUE OF D.S. NAME IS 3-FF00-IDENT.

        • Type of COBOL code = U: UNYSIS 2200 Series:

          • CR = card reader

          • CP = card punch

          • .UN = UNISERVO

          • .TP = tape

          • PN = printer with external name. If the Complement field contains a value, the RECORDING clause is also generated.

          • PT = printer without external name

          • PF = printer with external name and:

            • VALUE OF PRINTER-FORMS 3-FF00-FORMS

            • LINAGE IS 3-FF00-LINES

            • TOP IS 3-FF00-TOP

            • BOTTOM IS 3-FF00-BOTTOM

        These four data names are to be declared in work area lines with their appropriate values.

        • Type of COBOL code = O: AS/400:

          • RD = reader.

          • CP = card punch

          • DB = database

          • PT = printer.

          • TP = tape.

          • DK or blank = disk.

        Returns:
      • getPhysicalUnitTypeComplement

        ProgramPhysicalUnitTypeComplementValues getPhysicalUnitTypeComplement()

        It is a complement to the Physical unit type field. The purpose of this field varies according to the Type of COBOL code.

        Returns:
      • getSubScheme

        java.lang.String getSubScheme()

        A subschema is a group of Data Elements called in the Segment.

        This field is used with the Pactables function, to indicate which subschema is to be described. It is numeric, from 0 to 9 (0 corresponds to subschema 10).

        Returns:
      • getUnitType

        ProgramUnitTypeValues getUnitType()

        The value of this field is important in the Types of COBOL code for which the ASSIGN clause, the FD level and the WRITE statements are dependent on the selected unit type.

        Returns:
      • getUsage

        ProgramUsageValues getUsage()

        This code defines the role of the Data Structure in the Program and determines the generated functions.

        Returns: