Procedure Definition Processor (PDP) Operations Reference Manual - Documentation Updates

Transcription

1 Procedure Definition Processor (PDP) Operations Reference Manual - Documentation Updates Copyright 2013 Unisys Corporation All rights reserved. Unisys is a registered trademark of Unisys Corporation.

2 Updates to Procedure Definition Processor (PDP) Operations Reference Manual The following information identifies the known changes to this document at release time. These updates, and any future updates to this document, are provided in the problem list entry (PLE) identified below. To ensure you have the most current information for this document, contact your Unisys representative or access the current PLE from the Unisys Product Support Web site: Note: If you are not logged into the Product Support site, you will be asked to do so. Problem List Entry (PLE) Time 13:36:14 Date ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Number: Product: PDP Est Comp Date: Status: CLOSED Component: USER-DOC Date Updated: Type: RELEASED Form: TROUBLE REPORT Date Prepared: Class: DOCUMENTATION Originator: HILTUNEN-HOLLY Responsibility: HXH Location: ROSEVILLE Coordinator: HXH Internal Use: Manager: DWK Criticality: Organization: TPS Description Section Headline: Cumulative changes for the PDP Reference Manual, level 13R1,( UP and UP A). Product Level: 13R1C 13R1F 13R1G 13R1I 13R1K 13R2B Document Affected: UP UP A Internal Keyword: MAST-PLE-4-0 Symptoms: Symptoms Updated: This PLE contains corrections to the Series 1100 Procedure Definition Processor PDP Level 13R1 Reference (UP ) and the update package to it, (UP A, also level 13R1). Note that this PLE only contains corrections to software level 13R1C and higher. PLE to UCF: Resolution Section Documents: This PLE contains changes to the Procedure Definition Processor (PDP) Operations Reference Manual, Level 13R1 (UP ). The changes will be incorporated into the manual for its next release Resolution Comments: For UCF Insert the following paragraph at the end of subsection 2.1 on page 2-1: The symbolic input can contain a slash (/) in column 1 to 1

3 advance printing of the listing to the next page. The slash should appear on a symbolic input image alone because no further processing of the symbolic input image will be performed. The slash is also retained in the generated symbolic output. The effect of the slash when processed by a compiler or assembler is determined by the standard processing rules for that compiler or assembler. This capability of PDP will be documented in the next release of the OS 1100 Procedure Definition Processor (PDP) Reference Manual For UCF The following information applies to PDP levels 13R1C, 13R1D, 13R1E, 13R1F, 13R1G, and 13R1H only. Page 1-1 under "options" Change from: Are listed in Table 1-1. to: Are listed in Table 1-1 and Table 1-2. Change the last two paragraphs to read as follows: The E, L, and N options indicate the type of listing PDP prints. PDP suppresses all symbolic listings if no listing option is specified. If you specify two or more of these options on the PDP processor control statement, PDP issues a WARNING message to alert you to the option conflict and produces the listing using the option that produces the shortest listing possible. The remaining options control the input, output, and processing of PDP. Cycling of procedure elements is permitted. The cycle number can be increased if you specify the U option. When you include a procedure in an assembly or compilation, the procedure from the latest cycle of the procedure element is supplied. NOTE: The following options issue a WARNING message, indicating they are either not defined or not supported by the PDP processor: A, D, G, H, K, O, R, S, Y, and Z. Page 1-3 Remove the I and W options and their descriptions from Table 1-1. Insert Table 1-2 after Table 1-1, as follows: Table 1-2. SYSLIB SIR$ - Symbolic Input/Output Routine - Options Option Character Description G* Input is compressed symbolic in columns 1-80 of the symbolic images. Applies only with I option. (PDP does not support this SIR$ option.) 2

4 H* Input contains sequence numbers in columns of the symbolic images. Applies only with I option. (PDP does not support this SIR$ option.) I Read images from the runstream and insert them into a new symbolic. (The symbolic input in the runstream following processor control statement creates a symbolic source language procedure element. The "si" parameter specifies the name to be given to the symbolic source language procedure. If you supply an "so" parameter, SIR$ indicates an illegal field and PDP terminates and issues a FATAL ERROR message. The resultant procedure element is subtyped according to the procedure type option specified with the I option. The option letters for the available subtypes are: B = ASM, C = COB, F = FOR, J = PSP, and M = MSM.) J* Input contains compressed symbolic images in columns 1-72 of the images and sequence numbers in (PDP does not support this SIR$ option. Instead, PDP reuses this option to indicate a subtype of PSP for PLUS procedures, as indicated in Table 1-1.) K* Check sequence numbers in columns of the symbolic images. (PDP does not support this SIR$ option.) P Output symbolic in Fieldata. (Compare with Q option.) Q Output symbolic in ASCII. (If you specify neither P nor Q, PDP sets Q as the default option.) If you specify both P and Q, output symbolic with mixed images (if this capability is enabled in SIR$). U Read change images from the runstream, apply them to the symbolic input element, and produce a new cycle of the symbolic element. W List change images * A configurable feature that is disabled in the standard version of SIR$. Page 2-2 Replace: Any line image in the symbolic input, defining a COBOL PDP library entry that contains an asterisk in column seven is considered to be a comment line image no matter what characters precede or follow the asterisk character. With: An asterisk in column 7 normally indicates a comment image in COBOL. However, an asterisk in column 7 with a PDP PROC or END directive is ignored (see Appendix B). Page 3-1, 4th paragraph, 2nd sentence Change: The element cycle of this symbolic element is always zero (i.e., no "updating" of the symbolic input element to a higher element cycle may be performed using PDP.) 3

5 To: The element cycle of this symbolic element is always zero, unless the U option is specified. If you specify the U option, the next cycle of the symbolic element is created. Page 3-1, 5th paragraph. Change: Symbolic output is the same character code as the symbolic input, except when the symbolic input is in the Fieldata character set. In that case, the symbolic output is in the ASCII/ISO character set. To: The SIR$ Q option is assumed for symbolic output if you specify neither the P nor the Q option on processor control statement (see Table 1-2). Appendix A - PDP Diagnostic Messages Page A-6 (of section A.2), remove the error message that begins '*FATAL ERROR: SYSLIB SIR$ Correction Image...' and its explanatory paragraph and replace it with the following new error message and explanatory paragraph: *FATAL ERROR: SYSLIB SIR$ detected error(s) for one or more symbolic input images or symbolic output images This message is output at the end of the first pass through the source input if any SIR$ error conditions were reported during processing of the source input images. Each SIR$ error message is output as soon as it is returned to PDP by SIR$. The SYSLIB Programming Reference Manual, Appendix B, contains a complete description of SIR$ error messages. All messages indicate an error for PDP source input from the runstream or from the SI element or for PDP source output to the SO element. Page A-9 Delete following message and its related description: *ERROR: Procedure declaration encountered before function end - procedure declaration ignored Move following message and description from Page A-9 to A-11, updating it and inserting it alphabetically: Delete from A-9: *ERROR: Source line encountered before procedure declaration - line image ignored Insert on A-11: *WARNING: Source line encountered before procedure declaration - line image ignored A no-comment, unrecognizable line image was encountered before a valid PDP procedure declaration was encountered. Source language line images may only appear within the procedure text. Delete following message and its related description: *ERROR: Source line encountered between DEF directive and procedure 4

6 declaration - line image ignored Page A-10 Delete following message and its related description: *WARNING: Fieldata output is not allowed - ASCII output assumed Insert the following messages and descriptions alphabetically: *WARNING: Improperly coded comment line or unrecognizable line image - line image ignored If the line image appears to be a poorly coded comment line image, PDP will issue the above warning and proceed to the next line image. *WARNING: Invalid asterisk character appended to procedure name - character removed An invalid asterisk has been attached to a COBOL or FORTRAN procedure name. Even if the asterisk appears in column seven for COBOL, it will not be treated as a comment indicator when attached to a procedure name. PDP will remove the asterisk character from the procedure name. (See Appendix B.) *WARNING: Invalid "$" character preceding PDP DEF directive - character ignored The DEF directive appears to be a MASM $DEF directive instead of the PDP DEF directive. Since PDP does not recognize the MASM $DEF directive, PDP will ignore the "$" character and treat DEF as the PDP DEF directive. The MASM $DEF directive and PDP DEF directive are not synonymous. This WARNING should be checked and validated or corrected. *WARNING: Listing type option conflict between E and L options - E option assumed The E and L options are both used on processor control statement to produce the option conflict. The E option overrides the L option to produce the shorter of the two listings. Change the following message and its description From: *WARNING: Listing type option conflict - no listing assumed... The conflict is ignored and no listing is assumed. To: *WARNING: Listing type option conflict - N option assumed.... The N option overrides the others to produce the shortest listing possible. Move following message and description from Page A-10 to A-11, updating it and inserting it alphabetically: 5

7 Delete from A-10: *WARNING: Microstring in externalized MASM label, no substitution performed - externalized label ignored Insert on A-11: *WARNING: PROC or NAME declaration has microstring in externalized MASM label, no substitution performed - externalized label ignored PDP encountered a microstring in the symbol subfield of an externalized label. Because PDP does not do any microstring substitution, the actual symbol cannot be determined and therefore the label field is ignored. Page A-11 Change the following message and its description: From: *WARNING: Not defined or unsupported option specified - option ignored An A option was specified on statement which... To: *WARNING: Not defined or non_supported option specified - option ignored An option was specified on statement which... Insert alphabetically message moved from page A-10. Insert alphabetically message moved from page A-9. Appendix B. Restrictions Page B-2: Delete the following bulleted restriction and its description: [] FORTRAN Procedures (+description) Append these additional concerns/restrictions as bulleted items: (Note: quotes " indicate x's in italics - do not retain quotes.) [] COBOL comment ignored with PROC directive Any line image of the form "xxxxxx"* PROC [additional text] is treated as a procedure declaration and not as a comment line. The following warning message is issued: *WARNING: Invalid asterisk character appended to procedure name - character removed [] COBOL comment ignored with END directive Any line image with an END directive starting in column 2 and an asterisk in column 7 is treated as an END declaration. The COBOL compiler also treats this line image as the end of the procedure and ignores the other images that follow. 6

8 For UCF : On page 1-1, add the following before the B option: A Allow processing of embedded Kanji characters. On page 1-2, add the following note: NOTE: The following options issue a WARNING message, indicating they are either not defined or not supported by the PDP processor: D, G, H, K, O, R, S, Y, and Z. Resolution for Level: 13R1C 13R1F 13R1G 13R1I Resolution Status: NO FIX APPLIES Send To CSC: YES Closure Code: DOCUMENTATION DEFECT Final Resolution Date: Resolution for Level: 13R2B Resolution Status: NO FIX APPLIES Send To CSC: YES Closure Code: DOCUMENTATION DEFECT Final Resolution Date: ~~~~~~ Paper copy not controlled; EPAS on-line data is current. ~~~~~~ _ 7