EDIT - define edit options (BS2000 systems)

The EDIT control statement allows you to combine screen functions and screen output properties in line mode (edit options) in groups known as edit profiles. It also enables you to assign names to these edit profiles, which can then be used to address a set of edit options from a program unit.

The EDIT statement can be issued several times within a generation run. However, a different name (name operand) must be specified in each EDIT statement.

The edit profile names are specified in the KCMF field of the MPUT, MGET, DPUT, FPUT and FGET calls at the programming interface, where a blank is entered as the format control character.

openUTM interprets the entries in the KCMF field as follows:

No edit profiles generated	Edit profiles generated
If a blank is entered as the format control character, openUTM ignores the remaining characters in the field.	If a blank is entered as the format control character, the remaining characters in the field must contain either the name of a valid edit profile or further blanks.

A detailed description of the operands described below can be found in the „TIAM“ User Guide. Further information on working with edit profiles can be found in the openUTM manual „Programming Applications with KDCS”.

EDIT

name   [ ,BELL={ NO | YES } ]  [ ,CCSNAME=ccsname ]  [ ,HCOPY={ NO | YES } ]  [ ,HOM={ NO | YES } ]  [ ,IHDR={ NO | YES } ]  [ ,LOCIN={ NO | YES } ]  [ ,LOW={ YES | NO} ]    ,MODE={ EXTEND | INFO | LINE | PHYS | TRANS }  [ ,NOLOG={ NO | YES } ]  [ ,OHDR={ NO | YES } ]  [ ,SAML={ NO | YES } ]  [ ,SPECIN={ C | I | N } ]

name	Alphanumeric name up to seven characters in length for the set of edit options to be defined.
BELL=	This specifies whether or not an acoustic alarm is triggered on the terminal when a message is output.
CCSNAME=	ccsname (coded character set name) Name of the character set (CCS name) used to format a message. This name can be up to eight characters in length. The specified CCS name must belong to one of the EBCDIC character sets defined under the BS2000 system (see also the XHCS User Guide). The character set must be compatible with an ISO character set supported by the terminal to which the message is directed. During generation, KDCDEF cannot check the validity of the CCS name under the BS2000 system or the compatibility condition. A CCS name must not be assigned to the edit profile if the value TRANS (transparent mode) is defined for the MODE operand. If the edit profile is used to output messages to an RSO printer, only the CCSNAME= parameter of the edit profile is evaluated.
HCOPY=	(hard copy) This specifies whether the output message is to be logged on a connected hardcopy printer in addition to being displayed on the terminal.
HOM=	(homogeneous) This specifies whether the output message is to be output unstructured, i.e. in homogeneous format. If you enter NO here, the message is output in a structured format, i.e. in non-homogeneous format. In this case, a logical line is regarded as an output unit.
IHDR=	(input header) This specifies whether the header of the input message is to be transferred to the program unit.
LOCIN=	(local parameter input) This operand applies only for terminals that support local parameters (e.g. 9763). If you enter YES here, local attributes in the input message are forwarded to the user as logical control characters. If you enter NO here, local attributes are removed from the input message and are not forwarded. LOCIN=YES is permitted only if MODE=EXTEND.
LOW=	(lowercase) This specifies whether lowercase letters are permitted in the input message transferred to the program unit. If you enter NO here, the system converts all lowercase letters into uppercase.
MODE=
EXTEND	(extended line mode) This specifies whether the message is to be output in extended line mode. If you enter MODE=EXTEND, the value YES is permitted only for the BELL, LOW, and LOCIN edit options. The value N must be entered for the SPECIN operand.
INFO	The message is to be output in a special information line (system line) without overwriting important data at the terminal. This specification is primarily intended for application programs that send "asynchronous" messages to terminals without knowing what is currently being displayed at the terminal. At terminals with a hardware display line (e.g. DSS 9749, 9750, 9763), the data is always output protected in a hardware system line; in all other cases, it is output in the same way as a normal line mode message.
LINE	(line mode) The message is to be output in line mode. It can be structured using logical control characters, and is formatted by the system. If you enter MODE=LINE, the value NO must be entered for IHDR, OHDR and LOCIN.
PHYS	(physical mode) The message is to be output or read in physical mode, i.e. without being formatted by the system. If you enter MODE=PHYS, the value YES is permitted only for the IDHR, LOW and OHDR edit options. The value N must be entered for the SPECIN operand. This specification should not be used for messages output on a printer. Physical messages to a printer can only be implemented using a format exit.
TRANS	(transparent mode) The output message is to be transferred in transparent mode. If you enter MODE=TRANS, the value YES must not be specified for any other edit option. The value N must be entered for the SPECIN= operand. The CCSNAME= operand must not be specified.
NOLOG=	(no logical characters) This specifies how the system is to handle non-printable characters.
YES	The logical control characters are not evaluated. All characters less than X’40’ in EBCDIC code are replaced by alternate characters (SUB). Only printable characters are allowed through.
NO	All logical control characters are evaluated. Special physical control characters are allowed through. All other characters less than X’40’ are replaced by alternate characters (SUB). Printable characters are allowed through. Default: NO
OHDR=	(output header) This specifies whether the output message contains a header. The length of the message header + 1 must be entered in binary format in the first byte of the message.
SAML=	(same line) This applies only for printer stations. If SAML=YES, the message is not preceded by a line feed. If SAML=NO applies, the message begins at the start of the next line.
SPECIN=	(special input)
C	(confidential) This specifies whether the display of input data is to be suppressed on the terminal, thus protecting confidentiality.
I	(id-card) This specifies whether input data is to be entered via the ID card reader.
N	(normal) The terminal requires normal input.