Library View Topics Framed Contents Revised Topics Previous Topic Next Topic Search Search ResultsPrevious Topic MatchNext Topic Match Notes List Notes Print Download No PDF Handheld DisconnectedHandheld ConnectedHelp

3.1.4 Optional Paragraphs



These optional paragraphs in the Identification Division can be omitted:

AUTHOR
Name of the author of the program.

INSTALLATION
Name of the company or location.

DATE-WRITTEN
Date the program was written.

DATE-COMPILED
Date the program was compiled.

SECURITY
Level of confidentiality of the program.

The comment-entry in any of the optional paragraphs can be any combination of characters from the character set of the computer. The comment-entry is written in Area B on one or more lines.

The paragraph name DATE-COMPILED and any comment-entry associated with it appear in the output program listing with the current date inserted:


        DATE-COMPILED. 04/27/95.

Comment-entries serve only as documentation; they do not affect the meaning of the program. A hyphen in the indicator area (column 7) is not permitted in comment-entries.


X >_Workstation_> Under AIX, OS/2, and Windows, you can include multi-byte
X as well as single-byte characters in an EUC or DBCS code page in comment
X entries in the Identification Division of your program. Multiple lines
X are allowed in a comment-entry containing multi-byte characters.
X <_Workstation_<


X >_Host_> Under OS/390 and VM, you can include DBCS character strings as
X comment-entries in the Identification Division of your program. Multiple
X lines are allowed in a comment-entry containing DBCS strings.


X A DBCS string must be preceded by a shift-out control character and
X followed by a shift-in control character. For example:


 X   AUTHOR.       <.A.U.T.H.O.R.-.N.A.M.E>, XYZ CORPORATION
 X   DATE-WRITTEN. <.D.A.T.E>


X When using DBCS characters in a comment-entry contained on multiple lines,
X shift-out and shift-in characters must be paired on a line. <_Host_<


X DBCS strings are described under "Character-Strings" in topic 1.1.1.

Previous Topic Next Topic Copyright IBM Corp. 1991, 1998

IBM Library Server Copyright 1989, 2005 IBM Corporation. All rights reserved.





Return to library:   z/OS | z/OS.e | TPF | z/VSE | z/VM | IBM Hardware | IBM System z Redbooks
Glossary:   IBM terminology
Publications:   How to order publications
Readers:   Download IBM Library Reader | Download IBM Softcopy Reader | Download Adobe® Acrobat® Reader®
Library management:   Download IBM Softcopy Librarian
Contacts:   Contact z/OS


Adobe, the Adobe logo, Acrobat, the Acrobat logo, and Acrobat Reader are registered trademarks of Adobe Systems incorporated.