A - Page 1 - ----------------------------------------------------------------------- | README file for SDF-A V4.1 / SDF V4.7 | | Edition: December 2011 | ----------------------------------------------------------------------- Description of the changes/extensions of SDF-A V4.1G and SDF V4.7C. The changes/extensions concern the manual : SDF-A V4.1E Order No. U2284-J-Z125-9-76 Summary of the changes/extensions ================================= SDF-A V4.1G ----------- The operand values VALUE=*CMD-REST/*TEXT of the ADD-VALUE and MODIFY-VALUE statements have been extended. The language dependant texts (MODIFY-LANGUAGE-TEXT operand) of the SET-GLOBALS statement have been extended. SDF V4.7A --------- The CMDSEL macro, which is described in the "SDF-A" manual has been extended in SDF V4.7A. SDF V4.7B --------- Support of case sensitive values outside quotes. SDF V4.7C --------- New macro CMDSCA that offers a TU interface for the TPR function $CMDSCAI. As $CMDSCAI, CMDSCA is described in the SDF DHB. The CMDSEL macro, which is described in the "SDF-A" manual has been extended again in SDF V4.7C. Extension of messages CMD1000, CMD1100, CMD1200. Contents ======== 1. ADD-VALUE / MODIFY-VALUE statements.......................Page 2 2. SET-GLOBALS statement.....................................Page 2 3. Modified interface........................................Page 2 3.1 CMDSEL macro..........................................Page 2 3.2 Extended messages.....................................Page 4 A - Page 2 - 1. ADD-VALUE / MODIFY-VALUE statements The LOWER-CASE=*YES operand of the data types *CMD-REST and *TEXT contains a structure, which controls the processing of upper/lower case outside of quotes. These data type are provided only for special purposes for the Software Development and are therefore not described here. 2. SET-GLOBALS statement The language dependant texts (MODIFY-LANGUAGE-TEXT operand) are extended with the new data type attribute CASES-SENSITIVE=*NAMES(...) with the following defaults fot the language key E: LONG-NAME='case-sensitive' ABBREVIATION='case-sens.' 3. Modified interface 3.1 CMDSEL macro 3.1.1 Extended functionality 3 new operands have been added to the CMDSEL interface. 1 operand has been extended. 3.1.2 Extended interface description +-------------------------------------------------------------+ | | | CMDSEL | | | +-------------------------------------------------------------+ | | | TITLEL = / | | | | [ MESSAGE@ = ] | | default: NULL | | | | [ MESSAGEL = | | default: NULL | | | | [ MARKL = 1 / / ] | | default: 1 | | | +-------------------------------------------------------------+ A - Page 3 - Description of the parameters OUTPUT = Address of an area in which the result of the selection can be entered. As many bytes must be reserved as specified in the MARKL parameter for each of the selectable items, i.e. the area must have the byte length specified in LINENBR times the value specified in MARKL and be initialized with zero or blank. If the user selects the item(i) ( = o..m) with a value ( = 1..75), the bytes (i*n) til (i*n + (n-1)) receive that value in place of zero/blank. If an area is assigned a value other than zero or blank before the user selection, the corresponding item is the default value in the selection mask. TITLEL = / Length of the character string which is output as the title. This parameter is only evaluated if an address other than 0 is specified for TITLE@. The number of lines in the selection body depends on the number of lines in the title part (one line less per additional title line). MESSAGE@ = Specifies the address of a field containing the message to be displayed before any user selection. MESSAGEL = Specifies the length of a field containing the message to be displayed before any user selection. MARKL = 1 / / Maximal length of the mark value, hence the width of the mark column. The length limit of the rest of the selection line depends on this value (one character less per additional mark column character). 3.1.3 Additional return codes SC2 SC1 Maincode Meaning 0C 01 0008 Parameter error: TITEMS 0D 01 0008 Parameter error: TITEMSL 0E 01 0008 Parameter error: MARKL 0F 01 0008 Parameter error: MESSAGE@ 10 01 0008 Parameter error: MESSAGEL A - Page 4 - 3.1.4 Additional programming notes OUTPUT: the macro suppresses the NULs (0x00) in the input mark fields i.e. it concatenates the characters of the input mark column if they are separated by NULs and it keeps the rest length filled with NULs. TITLE and MESSAGE: the presented text can be longer than the text specified in the parameters because the macro inserts the carriage return such as to not cut short words in 2 lines. If the presented text is longer than 3 lines, it is truncated with "...". 3.2 Extended messages The messages CMD1000, CMD1100 and CMD1200 are extended with 2 Inserts for interface name and return code: CMD1000 INTERNAL ERROR: INTERFACE '(&00)', RETURNCODE '(&01)'. PROCESSING CONTINUES CMD1100 INTERNAL ERROR: INTERFACE '(&00)', RETURNCODE '(&01)'. TASK TERMINATION WITHOUT DUMP CMD1200 INTERNAL ERROR: INTERFACE '(&00)', RETURNCODE '(&01)'. TASK TERMINATION WITH DUMP