A Page 1 ---------------------------------------------------------------------- | README file for SDF-CONV V3.0B | | Edition: January 1995| ---------------------------------------------------------------------- This README file refers to the manual "SDF-CONV V3.0A", Edition February 1994 (order number: U6540-J-Z125-3-7600). All changes relevant to SDF-CONV V3.0B are listed below. Chapter and section names and page numbers (in parentheses) refer to the English edition of the manual. Contents: --------- Page re chapter 2 Components and installation of SDF-CONV..........2 re section 3.1 Updated start command............................2 re section 3.2.2 CONVERT statement................................3 re section 3.4.2 Restrictions on the conversion into S procedures.....................................3 re section 3.4.4 Non-convertible operand configurations and conditional conversions..........................4 re section 3.4.5 Restrictions on procedure parameters as operands re section 5.3.1 Table: Conversion of user commands...............7 re section 5.3.2 Table: Conversion of system administration commands.........................................7 re section 5.4 SDF-CONV messages................................7 A Page 2 re chapter 2, "Components and installation of SDF-CONV" (page 7) Changed: -------- - new name for the conversion routine: SYSPRG.SDF-CONV.030 - new declaration files as a result of splitting SYSSSC.SDF-CONV.030 (there is now no declaration file with this name): SYSSSC.SDF-CONV.030.110 Subsystem declaration for use in BS2000/OSD-BC V1.0 SYSSSC.SDF-CONV.030.112 Subsystem declaration for use in BS2000/OSD-BC V2.0 Paragraph "Subsystem installation" (page 8, middle) Extended: --------- The following command is to be issued, regardless of the operating system version: MODIFY-FILE-ATTRIBUTES SYSPRG.SDF-CONV.030, NEW-NAME=SDF-CONV,- USER-ACCESS=*ALL This enables SDF-CONV to be called by means of the START-PROGRAM command re section 3.1, "Starting and terminating the program" (page 10, middle) Changed: -------- ---------------------------------------------------------------------- | START-SDF-CONV | ---------------------------------------------------------------------- | VERSION = *STD / / | | ---- | | / | | | | | | ,MONJV = *NONE / | | ----- | | | | ,CPU-LIMIT = *JOB-REST / | | --------- | ---------------------------------------------------------------------- A Page 3 re section 3.2.2, "CONVERT statement" (page 12f, page 19) New: ---- Value *OSD-V2 in the TARGET-VERSION operand TARGET-VERSION = *CURRENT / *V10 / *V11 / *OSD-V1 / *OSD-V2 Description: TARGET-VERSION = *OSD-V2 The converted procedure is to able to run as of BS2000/OSD-BC V2.0. New: ---- Notes on the value *S-PROCEDURE(...) in the PROCEDURE-FORMAT operand (page 22) Job variable expressions are modified as follows: --> &(jobvariable) is converted to &(JV('jobvariable') In command and statement lines the job variables must begin with the character '&'. They must also begin with '&' in data lines, but the specification PROGRAM-INPUT=*STMT causes them to be interpreted as statements and not as data in this case. Procedure parameters are modified as follows: --> &procpar is converted to &(procpar) Procedure parameters must be defined in accordance with the following rules: - they must be declared in the procedure header ([BEGIN]PROC line) - they must begin with '&' in command and statement lines, and with the character specified under SUBDTA= in data lines - the line length must not exceed 20 characters (exception: positional parameters, which are automatically truncated by SDF-CONV) If any one of these rules is violated, any other procedure parameters with a similar format likewise remain unchanged. re section 3.4.2, "Restrictions on the conversion into S procedures" (page 34) Extended: --------- Within the brackets enclosing them, procedure parameters and job variables in S procedures can contain other expressions which are to be replaced (e.g. &(JOBVAR1&(JOBVAR2)). SDF-CONV does not support this feature. A Page 4 re section 3.4.4, "Non-convertible operand configurations and conditional conversions" (page 38ff) New: ---- Three new commands have been added to the table of restrictions: MODIFY-JV-CONDITIONALLY, PRINT-FILE and RESUME-PROCEDURE. The restrictions relating to these commands are caused by the ability of SDF-CONV to run in BS2000/OSD-BC V2.0. ---------------------------------------------------------------------- |ISP / SDF |Non-convertible operands |Explanation | |command |or operands which | | | |restrict conversion | | ---------------------------------------------------------------------- |PRINT-FILE |LAYOUT-CONTROL | | | | CHARACTER-SETS |This operand causes problems| | | |if specified at the same | | | |time as | | | |PRINTER-RESOURCES=APA | | | |(TABLE-REFERENCE-CHAR). | | | | | | | CHARS-MODIFICATION |Procedure parameters are not| | | |accepted as operand values. | | | | | | | CONTROL-CHARACTERS |Procedure parameters are not| | | |accepted as operand values. | | | | | | | =PHYSICAL( |Procedure parameters are not| | | LINE-SPACING=...) |accepted as operand values. | | | |The new PRINT-DOCUMENT | | | |command differentiates | | | |between SPOOL and RSO; as a | | | |result the default value is | | | |ignored. | | | | | | | =PHYSICAL(... |Procedure parameters are not| | | ,PAGE-CONTROL=..) |accepted as operand values. | | | | | | | =TRANSPARENT() |The new PRINT-DOCUMENT | | | |command differentiates | | | |between SPOOL and RSO; as a | | | |result the default value is | | | |ignored. | | | | | | | PRINTER-RESOURCES |Procedure parameters are not| | | =APA(...,TABLE- |accepted as operand values. | | | REFERENCE-CHAR=..) | | | | | | | | TRAY-NUMBER |This operand causes problems| | | |if specified at the same | | | |time as | | | |PRINTER-RESOURCES=LP65 | | | |(INPUT-TRAY-NUMBER=...). | | | | | | | ROTATION |Specification of a list is | | | |not supported. | ---------------------------------------------------------------------- Continued --> A Page 5 ---------------------------------------------------------------------- |ISP / SDF |Non-convertible operands | Explanation | |command |or operands which | | | |restrict conversion | | ---------------------------------------------------------------------- |PRINT-FILE |DELETE-FILE |Procedure parameters are | |(continued) | |accepted during conversion, | | | |but any value specified for | | | |ERROR-PROCESSING=*PAR | | | |(TRUNCATION=...) is ignored.| | |------------------------------------------------------| | |DEVICE-NAME |Procedure parameters are not| | | =...(DESTINATION=...) |accepted as operand values. | | | | | | | =...(DEVICE-TYPE=...) |This operand causes problems| | | |if specified at the same | | | |time as | | | |PRINTER-RESOURCES=LP65/APA. | | |------------------------------------------------------| | |ERROR-PROCESSING |Procedure parameters are not| | | |accepted as operand values. | | | | | | | =*PAR(TRUNCATION=...) |Procedure parameters are not| | | |accepted as operand values. | | |------------------------------------------------------| | |FILE-NAME | | | | =*SYSLST-NUMBER() |Specification of *EAM() and | | | |*SYSLST-NUMBER() in list | | | |form is not supported. | | | | | | | =*LIB-ELEM(..., |This suboperand is not | | | CREATION-DATE=...) |available in the new print | | | |command PRINT-DOCUMENT. | | | | | | | ---- |Procedure parameters are | | | |accepted as operand values, | | | |but if the procedure | | | |parameter is an integer | | | |(e.g. a SYSLST file number),| | | |the conversion result will | | | |be incorrect. | | |------------------------------------------------------| | |FILE-PART |Procedure parameters are not| | | |accepted as operand values. | | | | | | | =SECTION( | | | | SECTION-ID=... |Procedure parameters are not| | | ,FIRST-RECORD=.. . |accepted as operand values. | | | ,LAST-RECORD=...) | | | |------------------------------------------------------| | |RECORD-PART | | | | =PAR(FIRST-CHAR=... |If the operand value is | | | ,LAST-CHAR=...) |zero, it is converted to 1. | | |------------------------------------------------------| | |REPEAT |Procedure parameters are not| | | |accepted as operand values. | ---------------------------------------------------------------------- Continued --> A Page 6 ---------------------------------------------------------------------- |ISP / SDF |Non-convertible operands |Explanation | |command |or operands which | | | |restrict conversion | | ---------------------------------------------------------------------- |PRINT-FILE |SPOOLOUT-NAME |Procedure parameters are not| |(continued) | |accepted as operand values. | | |------------------------------------------------------| | |START-SPOOL |Procedure parameters are not| | | |accepted as operand values. | | | | | | | =NO |This operand value is no | | | |longer supported. | |--------------------------------------------------------------------| |MODIFY-JV- |SET-VALUE |Due to the changes in job | | CONDITION- | |variable syntax in BS2000/ | | ALLY | |OSD-BC V2.0 errors may occur| | | |in the interpretation of the| | | |link name. | |--------------------------------------------------------------------| |RESUME- |MODE=C |This operand is not | | PROCEDURE | |supported in BS2000/OSD-BC | | | |V2.0 as C can stand for | | | |COMMAND/CMD as well as for | | | |CURRENT. | | | |C is interpreted as COMMAND | | | |in earlier versions. | ---------------------------------------------------------------------- re section 3.4.5, "Restrictions on procedure parameters as operands" (page 41f) Extended: -------- Keyword operands have been extended in connection with the restrictions affecting the ERASE and PRINT commands: ---------------------------------------------------------------------- |ISP command |No parameter |No parameter as a value of | | |as positional |the keyword operand ... | | |operand ... | | ---------------------------------------------------------------------- |ERASE |<1>, <2> |LIST=, POS=, | | | |new: | | | |LA=, CR=, EX= | |--------------------------------------------------------------------| |PRINT |<1>, <2> |BINARY=, CHARS-POOL=, CONTROL=, | | | |COPIES=, DEFER=, DELETE-FILE=, | | | |DEVICE=, DEVIN=, FROM=, LOOP=, | | | |ROTATION=, SPACE=, TAPE=, TO=, | | | |TRANSLATION-TABLE=, VOLUME=, | | | |new: | | | |HEAD= | ---------------------------------------------------------------------- Page 7 re section 5.3.1, "Conversion of user commands" (page 83ff) New: ---- Two new commands (PRINT-DOCUMENT and ADD-FILE-LINK) are available for conversion with BS2000/OSD-BC V2.0. ---------------------------------------------------------------------- |ISP / SDF |Converted to SDF command |Comment | |command | | | ---------------------------------------------------------------------- |PRINT |PRINT-DOCUMENT |New command | |for BS2000/ | | | |OSD-BC V2.0 | | | |--------------------------------------------------------------------| |PRINT-FILE |PRINT-DOCUMENT |New command | |for BS2000/ | | | |OSD-BC V2.0 | | | |--------------------------------------------------------------------| |SET-FILE-LINK |ADD-FILE-LINK |New command | |for BS2000/ | | | |OSD-BC V2.0 | | | ---------------------------------------------------------------------- re section 5.3.2, "Conversion of system administration commands" (page 89f) Changed: -------- The component 'PUBLIC-VOLUME-SET' in command names has been renamed 'PUBSET'. New: --- The MODIFY-MSG-DEFAULTS command has been added to the table. ---------------------------------------------------------------------- |ISP / SDF |Converted to SDF command |Comment | |command | | | ---------------------------------------------------------------------- |EXCAT | | | | CANCEL |CANCEL-CATALOG-EXPORT | | | FORCE |FORCE-CATALOG-EXPORT | | | END |EXPORT-PUBSET |Command name changed | |--------------------------------------------------------------------| |IMCAT |IMPORT-PUBSET |Command name changed | | |IMPORT-CATALOG | | |--------------------------------------------------------------------| |MODIFY-MSG- |MODIFY-MSG-FILE-ASSIGNMENT |New in the table | | DEFAULTS | | | ---------------------------------------------------------------------- re section 5.4, "SDF-CONV messages" (page 91ff) Changed: -------- CVRF160 Response: Check whether the command /MODIFY-SDF-OPTIONS *NONE has been executed. New: ---- CVR0001 SDF-CONV (&00) STARTED