Previous Topic Next topic Print topic

Micro Focus Studio Enterprise Edition for Windows > General Reference > COBOL Language Reference > Part 2. Program Definition > Identification Division > The Program-ID Paragraph

The Program-ID Paragraph

The Program-ID paragraph gives the name by which a program is identified and assigns selected program attributes to that program.

ISO2002MF  The Program-ID paragraph specifies the name by which a program prototype is identified.

MF  The Program-ID paragraph specifies the name by which a call prototype is identified.

General Formats for Format 1


*

General Formats for Format 2


*
MF 

General Formats for Format 3


*
ISO2002MF 

General Formats for Format 4


*

Directives

  1. In addition to Compiler directives which provide flagging and modify the reserved word list, the following directives may impact either the syntax or the semantics described in this section.
    • CASE - determines whether upper-case and lower-case letters are considered equivalent.
    • DEFAULT-BYTE - sets the value for data items defined in Working-Storage Section without a VALUE clause.
    • MAPNAME - impacts the handling of non-alphabetic characters in the program-name.
    • PROGID-COMMENT - causes Format 1 to be assumed rather than Format 2.

Syntax Rules for All Formats

  1. OSVSVSC2MF Program-name-1 can be a nonnumeric literal specified with or without enclosing quotation marks. The content of the literal must follow the rules for formation of program-names, but may also contain the characters @, #, and $.
  2. Program-name-1 must not be the same as another user-defined word.

    OSVSMF Program-name-1 can be the same as another user-defined word.

Syntax Rules for Formats1 and 2

  1. OSVSVSC2  The first 8 characters of program-name-1 of a program that is not contained in another program should be unique in the system. The first character must be alphabetic; otherwise it is converted as follows:
    • 1 through 9 are changed to A through I respectively.
    • Anything else is changed to J.

    If a hyphen is used in characters 2 through 8 of program-name-1 in a program that is not contained in another program, it is changed to zero (0).

    The MAPNAME Compiler directive controls this behavior.

    VSC2 For programs that are contained in another program, program-name-1 can be any valid user-defined COBOL word, up to 30 characters long. The first eight characters need not be unique, and they will not be converted as described above. Lower-case letters are valid, but such program-names will be handled in a case-insensitive manner.

  2. ANS85 A program contained within another program must not be assigned the same name as that of any other program contained within the compilation unit that contains this program.

Syntax Rules for Format 2

  1. ANS85 The optional COMMON clause can be used only if the program is contained within another program.
  2. ANS85 If the IS PROGRAM phrase is present, at least one of COMMON or INITIAL

    ISO2002MFOS390 or RECURSIVE

    must be specified.

  3. ISO2002 Literal-1 must be an alphanumeric literal and must not be a figurative constant.
  4. ISO2002 Literal-1 must not be specified in a program that is contained within another program.
  5. ISO2002MF The RECURSIVE clause must not be specified if any program that directly or indirectly contains this program is an initial program.
  6. OS390 The RECURSIVE clause must not be specified in a program that is contained within another program.
  7. OS390 The RECURSIVE clause must not be specified in a program that contains another program.
ISO2002MF 

Syntax Rules for Format 4

  1. ISO2002MF Program-prototype-name-1 identifies the program prototoype. However, literal-1, if specified, is the name of the program prototype that is externalized to the operating environment.

General Rules for Formats 1 and 2

  1. Program-name-1 names the program declared by this program definition and is associated with the object code file pertaining to this program. Literal-1, if specified, is the name of the program that is externalized to the operating environment.

General Rules for Format 2

  1. ANS85  The COMMON clause specifies that the program is common. A common program is contained within another program but can be called from programs other than that containing it.
  2. ANS85  The INITIAL clause specifies that the program is initial. When an initial program is called, it and any programs contained within it are placed in their initial state. See the topic Initial State in the chapter Language Fundamentals.
  3. ISO2002MFOS390 The RECURSIVE clause specifies that the program is recursive.

    ISO2002MF Any programs contained within a recursive program are recursive.

    ISO2002MFOS390 A program in which the Local-Storage Section is specified is recursive.

    A recursive program may be called while it is active and may call itself.

  4. ISO2002MFOS390 If the RECURSIVE clause is not specified in a program or implied for a program, the program must not be called while it is active.
  5. ISO2002MFOS390 Additional rules concerning common, initial and recursive programs are given in the topic Common, Initial and Recursive Attributes in the chapter Language Fundamentals
MF 

General Rules for Format 3

  1. MF Program-name-1 names the call prototype that will be used during syntax checking to determine the validity and nature of CALL literal statements.
Parent topic: Identification Division
Related reference
Program Identification and Data Names
Related information
Initial State
Common, Initial and Recursive Attributes
Previous Topic Next topic Print topic