The MODIFY-LMS-DEFAULTS statement allows modification of the default values. If an explicit value is used locally in an LMS statement, this value will take priority over the default.
The reference in the LMS statements to the values set here is the specification of *LMS-DEFAULT.
At the beginning of the LMS run the values immediately following *UNCHANGED are valid.If one of these values is changed by the MODIFY-LMS-DEFAULTS statement, this new setting becomes the current setting. This remains valid for the LMS run (*UNCHANGED) until a new MODIFY-LMS-DEFAULTS statement for this value or RESET-LMS-DEFAULTS is issued.
MODIFY-LMS-DEFAULTS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ELEMENT-ATTRIBUTES = *UNCHANGED / *PARAMETERS(...)
Defines the member type, member version, storage form and file attributes.
TYPE = *UNCHANGED / *NONE / <alphanum-name 1..8>Defines the member type.
TYPE = *NONE
No global member type is defined, i.e. the type specifications must be made locally in statements if the library specified in the statement has no library-specific default type.
TYPE = <alphanum-name 1..8>
The name specified here is used as the type in the statements if the library specified in the statement has no library-specific default type. Otherwise, this library-specific default type replaces the local *LMS-DEFAULT in the statement.
ELEMENT-VERSION = *UNCHANGED / *ALL / *HIGHEST-EXISTINGDefines the member version for SHOW-ELEMENT-ATTRIBUTES.
ELEMENT-VERSION = *ALL
All versions of a member are output.
ELEMENT-VERSION = *HIGHEST-EXISTING
Only the highest existing version of a member with reference to BASE is output.
TO-ELEMENT-VERSION = *UNCHANGED / *BY-SOURCE / *HIGHEST-EXISTING / *INCREMENT
Defines the version of the target member.
TO-ELEMENT-VERSION = *BY-SOURCE
The target member receives the same version as the source member.
TO-ELEMENT-VERSION = *HIGHEST-EXISTING
Depending on the convention applicable for the type, this overwrites the highest existing version with reference to BASE among the members of the same type and name; otherwise a default version is generated.
TO-ELEMENT-VERSION = *INCREMENT
Depending on the convention applicable for the type, this generates a new, higher version among existing members having the same type and name; otherwise a default version is generated.
STORAGE-FORM = *UNCHANGED / *STD / *FULL / *DELTA
Storage form for the member being added. The storage form must not contradict the settings made by means of the MODIFY-TYPE-ATTRIBUTES or MODIFY-LIBRARY-ATTRIBUTES statements, and all members of a given type and name must have the same storage form.
STORAGE-FORM = *STD
The member is generated in accordance with the storage form required for the member scope. Contradictory requirements result in errors. If nothing is specified, full storage is selected.
STORAGE-FORM = *FULL
The new member is generated as a full member (if this is not possible, an error message is issued).
STORAGE-FORM = *DELTA
The new member is generated as a delta member (if this is not possible, an error message is issued). This entry is permissible for member types: S, P, D, J, M, X and members types derived from them.
SOURCE-ATTRIBUTES = *UNCHANGED / *STD/ *IGNORE / *KEEP
Evaluated only for the ADD-ELEMENT statement.
SOURCE-ATTRIBUTES = *STD
No file attributes and no ISAM key are stored. For ISAM files, a warning is output stating that the ISAM keys were not stored.
SOURCE-ATTRIBUTES = *IGNORE
As for SOURCE-ATTRIBUTES = *STD, but no warning is output.
SOURCE-ATTRIBUTES = *KEEP
The following file attributes are stored unchanged in the member being added: ACCESS-METHOD, RECORD-FORMAT, RECORD-SIZE, BUFFER-LENGTH, PERFORMANCE, USAGE, ACCESS and USER-ACCESS.
If ACCESS-METHOD=ISAM, then PADDING-FACTOR, LOGICAL-FLAG-LENGTH, VALUE-FLAG-LENGTH, PROPAGATE-VALUE-FLAG, the ISAM keys and information on ISAM secondary keys are also stored.
LMS stores the Last Byte Pointer (LBP) in addition to the previously stored file attributes
- for PAM members of type X
- for members of type C if KEEP-TYPES = *ALL has been specified
KEEP-TYPES = *LMS-DEFAULT / *STD / *ALL
Specifies types of members for which file attributes are to be stored.
KEEP-TYPES = *STD
Attributes are stored for members of base types S,M,P,D,J,X.
KEEP-TYPES = *ALL
Attributes are stored for members of all base types that are permissible for ADD-ELEMENT.
FILE-ATTRIBUTES = *UNCHANGED / *PARAMETERS(...)
File attributes that are defined on file creation.
ACCESS-METHOD = *UNCHANGED / *ISAM / *SAM
Defines the file access method.
ACCESS-METHOD = *ISAMCreates an ISAM file.
ACCESS-METHOD = *SAMCreates a SAM file.
DESTROY-DATA = *UNCHANGED / *NO / *YES / *BY-SOURCE
Determines whether the data is physically deleted, i.e. overwritten with X’00’.
DESTROY-DATA = *NO
A member of a library is deleted physically only if it contains a flag for physical deletion or the class 2 option DESTLEV requires it.
DESTROY-DATA = *YES
After logical deletion the data, if present, is physically deleted.
DESTROY-DATA = *BY-SOURCE
The code for overwriting the data is taken from the source member or the source file and assigned to the target member or the target file. If no source exists, *BY-SOURCE then has the same effect as DESTROY-DATA=*NO.
WRITE-MODE = *UNCHANGED / *CREATE / *REPLACE / *EXTEND / *ANY
Overwriting of a member having the same name. If the member does not exist under this name, it will be created as a new member.
If the member to be stored is a delta member, it is necessary to ensure that the member is a leaf of the delta tree. Only leaves of a delta tree may be overwritten.
If the value selected for WRITE-MODE is not possible for a particular statement, the setting WRITE-MODE=*CREATE applies.
WRITE-MODE = *CREATE
The target member must not yet exist and is created as a new member.
WRITE-MODE = *REPLACE
The target member must already exist and is replaced.
WRITE-MODE = *EXTEND
The target member is extended if it already exists. Otherwise it will be created as a new member.
WRITE-MODE = *ANY
The target member is replaced if it already exists. Otherwise it will be created as a new member.
DIALOG-CONTROL = *UNCHANGED/ *NO / *YES / *ERROR
This operand determines whether or not a dialog is to be conducted with the user during execution of a statement. (This operand has no effect in procedures or in batch mode.)
DIALOG-CONTROL = *NO
All members are processed without dialog queries.
Exception: If a member or a library is locked, LMS inquires whether the attempt to access it shall be repeated.
DIALOG-CONTROL = *YES
LMS inquires as to how it should act for each member, e.g. whether the member is to be processed, skipped or the statement terminated.
DIALOG-CONTROL = *ERROR
If a recoverable error occurs during member processing, e.g. a member being overwritten, the user is asked how LMS should act.
The user has the following intervention options, where applicable:
YES | The member is to be processed. |
After pressing the K2 key and entering “/SEND-MSG”, the user has the option of changing the value of the DIALOG-CONTROL operand. If LMS is in the midst of member processing, the user can control further processing as follows with the /SEND-MSG command shown below:
/SEND-MSG PROG, ́[N-I / N-E / C][,DIALOG-CONTROL= NO / YES / ERROR] ́
SEND-MSG PROG, NEXT-INPUT (N-I)
The current statement is aborted; LMS reads in another statement as soon as it is active again. Entering an unknown text or omitting the text has the same effect as NEXT-INPUT.
SEND-MSG PROG, NEXT-ELEMENT (N-E)
Processing of the current member in the current statement in aborted; LMS continues processing with the next member if there is one. If there is none, NEXT-ELEMENT has the same effect as NEXT-INPUT.
SEND-MSG PROG, CONTINUE (C)
LMS processing continues normally.
| The member is to be processed but without activating the dialog. |
| Member processing or the statement is to be terminated but without |
| The member is to be processed and the dialog subsequently activated. |
| Member processing or the statement is to be terminated and the dialog |
Note
The value set with /SEND-MSG for DIALOG-CONTROL applies only to the current statement.
INFORMATION = *UNCHANGED / *MEDIUM / *MINIMUM / *MAXIMUM / *SUMMARY / *DELTA-STRUCTURE / *PARAMETERS(...)
Specifies the scope of the directory to be output.
INFORMATION = *MEDIUM
Outputs the type, name, version, variant number and, depending on the SORT operand, the date or size of the selected member.
INFORMATION = *MINIMUM
Outputs only type, name and version of the selected member.
INFORMATION = *MAXIMUM
Outputs the complete information on the selected member.
INFORMATION = *SUMMARY
Outputs only the number of selected members per type.
INFORMATION = *DELTA-STRUCTURE
Outputs the relation “predecessor - successor” for delta members.
In addition to the member designation, this outputs the internal delta number (DELTA#, which reflects the chronological order) and the corresponding number of the base (BASE#). These internal delta numbers are unique within their tree and describe the concatenation of members in the tree (apart and distinct from the user’s own, external version designation). Tree output is always sorted according to DELTA#, i.e. the operand SORT (see below) has no effect within a tree. Different trees are separated from one another by a line.
In the case of full members, the DELTA# and BASE# output fields are empty.
INFORMATION = *PARAMETERS(...)
Additional outputs
GENERAL = *UNCHANGED / *NO / *YES
Defines whether, in addition to the type, name, version and variant number, a general information block is to be output comprising the storage format, status, member size and, if applicable, the character set and HOLDER of the selected member.
HISTORY = *UNCHANGED / *NO / *YES
Defines whether, in addition to the type, name, version and variant number, a HISTORY block is to be output comprising the user date/time, creation date/time, modification date/time and, if applicable, the access date/time of the selected member.
SECURITY = *UNCHANGED / *NO / *YES
Defines whether, in addition to the type, name, version and variant number, a SECURITY block for the selected member is to be output, if additional member protection has been granted for an access or borrowing right.
LAYOUT = *UNCHANGED / *VARIABLE / *FIXEDSpecifies the format of the directory to be output.
LAYOUT = *VARIABLE
The number of print columns is determined by the longest member designation within the member type. With output to the screen and no special sorting, the layout is oriented to the longest member designation in the output buffer, where subsequent outputs within a member type only change if longer member designations occur.
LAYOUT = *FIXED
The directory is printed in a single column in a fixed format. Here, column is meant to signify the list of entries, one below the other, in the directory.
SORT = *UNCHANGED / *BY-NAME / *BY-VERSION / *BY-USER-DATE / *BY-CREATION-DATE / *BY-MODIFICATION-DATE / *BY-ACCESS-DATE / *BY-ELEMENT-SIZE / *BY-SECONDARY-NAME
Sort criterion for the directory entries of the selected members. Type is always used as the first sort criterion.
SORT = *BY-NAME
Sorts the directory entries of the selected members according to the following criteria in the order specified: type, name and version.
SORT = *BY-VERSION
Sorts the directory entries of the selected members according to the following criteria in the order specified: type, version and name.
SORT = *BY-USER-DATE
Sorts the directory entries of the selected members according to the following criteria in the order specified: type, user date, name and version.
SORT = *BY-CREATION-DATE
Sorts the directory entries of the selected members according to the following criteria in the order specified: type, creation date, name and version.
SORT = *BY-MODIFICATION-DATE
Sorts the directory entries of the selected members according to the following criteria in the order specified: type, modification date, name and version.
SORT = *BY-ACCESS-DATE
Sorts the directory entries of the selected members according to the following criteria in the order specified: type, access date, name and version.
SORT = *BY-ELEMENT-SIZE
Sorts the directory entries of the selected members according to the following criteria in the order specified: type, member size, name and version.
SORT = *BY-SECONDARY-NAME
Sorts the directory entries of the selected members according to the following criteria in the order specified: type, secondary name, secondary attribute, name and version.
Note
For more information, see the SHOW-ELEMENT-ATTRIBUTES statement.
OUTPUT-FORM = *UNCHANGED / *STD / *CHARACTER / *HEXADECIMAL / *DUMPSpecifies the format for the output.
OUTPUT-FORM = *STD
The format is selected according to the member type. For text members this operand works in the same way as for OUTPUT-FORM = *CHARACTER.
OUTPUT-FORM = *CHARACTER The output is in alphanumerical form.
OUTPUT-FORM = *HEXADECIMAL
The output is displayed in mixed alphanumerical/hexadecimal form, with the alphanumerical form above and the hexadecimal form below.
OUTPUT-FORM = *DUMP
The output is displayed in mixed alphanumerical/hexadecimal form, with the two forms displayed side by side
For member types S, P, D, J and M, this operand has an effect like *HEXADECIMAL.
DELETE-SOURCE = *UNCHANGED / *NO / *YES
Specifies whether the source file is to be kept (default *NO) or deleted (parameter *YES). This operand has no effect if the data is read from *OMF.
PROTECTION = *UNCHANGED / *STD / *BY-SOURCEMember protection for a member or file protection for a file.
PROTECTION = *STD
In the case of member protection:
If the member already exists, its member protection remains unchanged. If the member does not yet exist and initial member protection has been defined for the relevant library or the member type, the member is given the protection specified here.
In the case of file protection:
The member protection in effect is not taken into account in the file protection given to the file being generated.
PROTECTION = *BY-SOURCE
Specifies that protection equivalent to the source’s is to be applied. There are three possible cases:
A member being copied is given the same protection as the source member.
A member being added is given member protection corresponding to the file protection attributes of the source file’s access protection mechanism.
A file being generated is assigned an access protection mechanism corresponding to the member protection in effect for the source member.
MAX-ERROR-WEIGHT = *UNCHANGED / *SERIOUS / *SIGNIFICANT / *RECOVERABLE
Specifies the errors which are to cause LMS to trigger the spin-off mechanism.
MAX-ERROR-WEIGHT = *SERIOUS
The spin-off mechanism is to be triggered in the event of serious errors, i.e. errors which make it pointless to continue processing the statement.
MAX-ERROR-WEIGHT = *SIGNIFICANT
The spin-off mechanism is to be triggered as with *SERIOUS, but also in the event of other errors (except when a member cannot be found or overwritten).
MAX-ERROR-WEIGHT = *RECOVERABLE
The spin-off mechanism is to be triggered in the event of any error.
EDT-MODE = *UNCHANGED / *COMPATIBLE / *UNICODE
Specifies the mode that EDT is to be called in.
EDT-MODE = *COMPATIBLE
EDT is called in compatibility mode.
EDT-MODE = *UNICODE
EDT is called in Unicode mode.
RUN-MODE = *UNCHANGED / *STD / *BATCH
When LMS is running in interactive mode, determines whether LMS should run normally or behave as if it is running in batch mode. (This operand has no effect in procedures or in batch mode.)
RUN-MODE = *STD
LMS is running normally.
RUN-MODE = *BATCH
LMS is running in batch mode.
NEXT-ATTEMPT = *UNCHANGED / *NO / *YES(...)
Controls further attempts to open a source when a file, type, or member lock is encountered in a procedure or in batch mode.
NEXT-ATTEMPT = *NO
Specifies that no further attempts are to be made to open the source.
NEXT-ATTEMPT = *YES(...)
Specifies that further attempts are to be made to open the source.
NUMBER-OF-ATTEMPTS = *UNCHANGED / <integer 1..2147483647> Number of further attempts to be made (default is 9).
PERIOD = *UNCHANGED / <integer 1..21599>
Wait time, in seconds, between attempts (default is 6).
COMPARE-PARAMETERS = *UNCHANGED / *PARAMETERS(...)
Specifies the comparison parameters, the type of comparison (formal or logical) and the scope and format of logging.
RECORD-PART = *UNCHANGED / *ALL / *PART(...)Defines the record area to be compared.
RECORD-PART = *ALL
The entire record is compared.
RECORD-PART = *PART(...)
Area specification for the part of the record to be compared.
START = *UNCHANGED / <integer 1..32764>
Starting point of the area containing the part of the record to be compared. If no value is entered, the record is compared starting at the beginning.
LENGTH = *UNCHANGED / *REST / <integer 1..32764>
Length of the area in the record to be compared. If no value is entered, the record is compared starting at the beginning.
SPACES = *UNCHANGED / *STD / *IGNORED / *RELEVANTHandling of space characters in the record.
SPACES = *STD
As *IGNORED for text members, otherwise as *RELEVANT.
SPACES = *IGNORED
Logical comparison. The comparison fields are compared one character at a time; spaces are ignored.
SPACES = *RELEVANT
Formal comparison. The comparison fields are first checked for matching length. If the lengths match, the fields are compared in their entirety. If the lengths differ, the records are logged as being non-matching.
INFORMATION = *UNCHANGED / *MEDIUM / *MINIMUM / *MAXIMUM /*SUMMARY / *STATISTICS/ *NONE
Scope of logging.
INFORMATION = *MEDIUM
Standard comparison log. The comparison range of non-matching records is logged in its entirety. With matching records, only range specifications (record numbers) are logged. The comparison statistics are output.
INFORMATION = *MINIMUM
Minimum comparison log.
For matching and non-matching records, only range specifications (record numbers) are logged. The comparison statistics are output.
INFORMATION = *MAXIMUM Detailed comparison log.
All records are logged.
The comparison statistics are output.
INFORMATION = *SUMMARY
No comparison log. Only the comparison statistics are output.
INFORMATION = *STATISTICS
No comparison log. The comparison statistics are output in compressed format.
INFORMATION = *NONE
No logging (no comparison log, no comparison statistics).
*NONE is expedient only when the SHOW-STATISTICS statement is used.
LAYOUT = *UNCHANGED / *COMPATIBLE / *COMPRESSEDLogging format.
LAYOUT = *COMPATIBLE
The comparison log is output in standard format. This format is compatible with earlier LMS versions.
LAYOUT = *COMPRESSED
The comparison log is output in a compressed format.
JOIN-ELEMENT-SETS = *UNCHANGED / *NO / *YES
Defines the member set to be compared.
JOIN-ELEMENT-SETS = *NO
Only the primary members and the secondary members determined through construction are used for the comparison.
JOIN-ELEMENT-SETS = *YES
All primary and secondary members are used for the comparison.
TEXT-INFORMATION = *UNCHANGED / *ALL / *STATISTICS / *FILE-ATTRIBUTES / *PARAMETERS(...)
Specifies the scope of information to be output for all members except members of types R, C and L. For PAM members, all entries except *FILE-ATTRIBUTES have an effect like *ALL.
TEXT-INFORMATION = *ALL Outputs everything.
TEXT-INFORMATION = *STATISTICS
Outputs the number of records per record type and their total.
TEXT-INFORMATION = *FILE-ATTRIBUTES
Outputs only the stored file attributes.
TEXT-INFORMATION = *PARAMETERS(...)
Specifies the section of the member which is to be output.
INFORMATION = *UNCHANGED / *ALL / list-poss(2): *TEXT / *COMMENT
The member section to be output
INFORMATION = *ALL Everything is output.
INFORMATION = *TEXT
Outputs the text itself, i.e. record type 1.
INFORMATION = *COMMENT
Outputs the separately stored comment, i.e. record type 2.
RECORD-RANGE = *UNCHANGED / *ALL / *RANGE(...)
The section of the member to be processed.
RECORD-RANGE = *ALL All records are processed.
RECORD-RANGE = *RANGE(...)
Specifies the range of record numbers which is to be processed. The record numbers refer not to a record type, but to the section of the member designated by means of INFORMATION=. Within this section, the records are numbered consecutively from 1 through n.
FROM = *UNCHANGED / <integer 1..2147483647>
Specifies the first record number to indicate the beginning of the section. If nothing is specified, record number 1 is assumed.
TO = *UNCHANGED / *LAST / <integer 1..2147483647>
Specifies the last record number to indicate the end of the section. If nothing is specified, the last record number is used.
RECORD-PART = *UNCHANGED / *ALL / *PART(...)
Specifies the part of the record to be processed.
RECORD-PART = *ALL Processes the entire record.
RECORD-PART = *PART(...)
Specifies the part of the record to be processed. If the default values are not changed, the entire record is processed.
START = *UNCHANGED / <integer 1..262144>
Specifies the first character in the record to indicate the beginning of the section. If nothing is specified, the first character is assumed to be the beginning.
LENGTH = *UNCHANGED / *REST / <integer 1..262144>
Specifies the length of the section. If nothing is specified, the rest of the record is taken as the length. LENGTH = 0 means that only the record headers are output
RECORD-NUMBER = *UNCHANGED / *BY-OUTPUT / *YES / *NO
Controls the output of the record numbers.
RECORD-NUMBER = *BY-OUTPUT
Record numbers will be output in all cases except when the output is directed to SYSOUT.
RECORD-NUMBER = *YES
Record numbers will also be output via SYSOUT.
RECORD-NUMBER = *NO
No record numbers are to be output.
MODULE-INFORMATION = *UNCHANGED /*ALL / *STATISTICS / *PARAMETERS(...)
Specifies the scope of information to be output for object modules (type-R members).
MODULE-INFORMATION = *ALL
Outputs everything.
MODULE-INFORMATION = *STATISTICS
Outputs the names, lengths and addresses of the CSECTS, as well as the overall length of the module.
MODULE-INFORMATION = *PARAMETERS(...)
Specifies whether all or only selected record types are to be output.
INFORMATION = *UNCHANGED / *ALL / *TXT(...) / *TXTP(...) / list-poss(9): *ESD / *ISD / *LSD / *RLD / *REP / *INCLUDE / *DSDD / *REF / *END
The record types listed here may be selected.
INFORMATION = *TXT(...) Selects text records.
CSECT-NAME = *UNCHANGED / *ALL / <c-string 1..32 with-low> / <text 1..32>
The text records can be limited to those from a CSECT.
ADDRESS = *UNCHANGED(...) / <x-string 1..8>(...) Start address of the text.
BASE-ADDRESS = *UNCHANGED / <x-string 1..8>
The base address specified here is added to the start address.
LENGTH = *UNCHANGED / *REST / <integer 1..2147483647> / <x-string 1..8>
Length of the text.
INFORMATION = *TXTP(...) Outputs TXTP records.
MODIFICATION-ID = *UNCHANGED / *ALL / <c-string 1..8 with-low> / *RANGE(...)
Selects TXTP records using the specified identification.
MODIFICATION-ID = *RANGE(...)
Selects multiple TXTP records in a range.
FROM = *UNCHANGED / *LOWEST / <c-string 1..8 with-low>
Specifies the beginning of the range. If nothing is specified, the lowest identification for the TXTP records is used.
TO = *UNCHANGED / *HIGHEST / <c-string 1..8 with-low>
Specifies the end of the range. If nothing is specified, the highest identification for the TXTP records is used.
PHASE-INFORMATION = *UNCHANGED / *ALL / *STATISTICS / *PARAMETERS(...)
Specifies the scope of information to be output for phases (type-C members).
PHASE-INFORMATION = *ALL Outputs everything.
PHASE-INFORMATION = *STATISTICS
Outputs the name, length and address of the segment, as well as its overall length.
PHASE-INFORMATION = *PARAMETERS(...)
Specifies whether all or only selected record types are to be output.
SEGMENT = *UNCHANGED / *ALL / *ROOT / <name 1..8>
The phase segment which is selected.
INFORMATION = *UNCHANGED / *ALL / *TXT(...) / *TXTP(...) / list-poss(4): *ESD / *ISD / *LSD / *RLD
The record types listed here may be selected.
INFORMATION = *TXT(...) Selects text records
ADDRESS = *UNCHANGED(...) / <x-string 1..8>(...)
Start address of the text.
BASE-ADDRESS = *UNCHANGED / <x-string 1..8>
The base address specified here is added to the start address.
LENGTH = *UNCHANGED / *REST / <integer 1..2147483647> / <x-string 1..8>
Length of the text.
INFORMATION = *TXTP(...) Outputs TXTP records.
MODIFICATION-ID = *UNCHANGED / *ALL / <c-string 1..8 with-low> / *RANGE(...)
Selects TXTP records using the specified identification.
MODIFICATION-ID = *RANGE(...)
Selects multiple TXTP records in a range.
FROM = *UNCHANGED / *LOWEST / <c-string 1..8 with-low>
Specifies the beginning of the range. If nothing is specified, the lowest identification for the TXTP records is used.
TO = *UNCHANGED / *HIGHEST / <c-string 1..8 with-low>
Specifies the end of the range. If nothing is specified, the highest identification for the TXTP records is used.
LLM-INFORMATION = *UNCHANGED / *ALL / *STATISTICS / *PARAMETERS(...)
Specifies the scope of information to be output for link and load modules (type-L members).
LLM-INFORMATION = *ALL Outputs everything.
LLM-INFORMATION = *STATISTICS
Outputs general information about the link and load module (name, copyright, etc.).
LLM-INFORMATION = *PARAMETERS(...)
Specifies whether all or only selected record types are to be output.
LLM-PART = *UNCHANGED / *ALL / *SLICE(...) / *SUB-LLM(...)
Specifies the part of the LLM which is to be selected.
LLM-PART = *SLICE(...) Specifies the slice to be output.
NAME = *UNCHANGED / <structured-name 1..32>
Name of the slice to be output.
LLM-PART = *SUB-LLM(...) Specifies the SUB-LLM to be output.
PATH-NAME = *UNCHANGED / <c-string 1..255 with-low> / <text 1..255>
Specifies the SUB-LLM to be output by means of its path name.
INFORMATION = *UNCHANGED / *ALL / *TXT(...) / *TXTP(...) / *LOGICAL(...) / *PHYSICAL / *REF / list-poss(4): *RELOCATION / *ESVD / *ESVR / *LRLD
The record types listed here may be selected.
INFORMATION = *TXT(...) Selects text records.
CSECT-NAME = *UNCHANGED / *ALL / <c-string 1..32 with-low> / <text 1..32>
The text records can be limited to those from a CSECT.
ADDRESS = *UNCHANGED(...) / <x-string 1..8>(...)
Start address of the text.
BASE-ADDRESS = *UNCHANGED / <x-string 1..8>
The base address specified here is added to the start address.
LENGTH = *UNCHANGED / *REST / <integer 1..2147483647> / <x-string 1..8>
Length of the text.
INFORMATION = *TXTP(...)
Outputs TXTP records.
CSECT-NAME = *UNCHANGED / *ALL / <c-string 1..32 with-low> / <text 1..32>
The TXTP records can be limited to those from a CSECT.
MODIFICATION-ID = *UNCHANGED / *ALL / <c-string 1..12 with-low> / *RANGE(...)
Selects TXTP records using the specified identification.
MODIFICATION-ID = *RANGE(...)
Selects multiple TXTP records in a range.
FROM = *UNCHANGED / *LOWEST / <c-string 1..12 with-low>
Specifies the beginning of the range. If nothing is specified, the lowest identification for the TXTP records is used.
TO = *UNCHANGED / *HIGHEST / <c-string 1..12 with-low>
Specifies the end of the range. If nothing is specified, the highest identification for the TXTP records is used.
INFORMATION = *LOGICAL(...)
Outputs the logical structure of the LLM.
LEVEL = *UNCHANGED / *ALL / *NEXT
Specifies whether all or only the next substructure is to be output. The default is all.
INFORMATION = *PHYSICAL
Outputs the physical structure of the LLM.
Statement return code
(SC2) | Maincode | Meaning |
0 | CMD0001 | No error |
Examples
The file TEST1 is to be added as a type D member to library LIB3.
The default setting for the member type is changed to the desired value by means of the MODIFY-LMS-DEFAULTS statement. In this way it is no longer necessary to specify the member type for each of the subsequent ADD-ELEMENT statements. In order that LMS may report successful addition of the files, the MODIFY-LOGGING-PARAMETERS statement is used to set the scope of logging to the complete LMS log.
/START-LMS
//OPEN-LIBRARY LIB3,*UPDATE
//MODIFY-LMS-DEFAULTS TYPE=D
//MODIFY-LOGGING-PARAMETERS LOGGING=*MAXIMUM
//ADD-ELEMENT TEST1
INPUT FILE
OUTPUT LIBRARY= :1OSQ:$USER.LIB3
ADD :1OSQ:$USER.TEST1 AS (D)TEST1/@(0001)/2012-11-12
//END
The library LIBCCSN contains an element LONGR in EDF03IRV code with records longer than 256 bytes. In order to edit these long records with EDT, EDT must be called in Unicode-mode.
Therefore the default setting for the EDT operating mode (COMPATIBLE) is changed to the desired Unicode mode by means of the MODIFY-LMS-DEFAULTS statement.
Now the EDIT-ELEMENT statement calls EDT in Unicode mode, which allows to edit long records, and reads the LONGR element into work file 0.
//START-LMS //MOD-LMS-DEF EDT-MODE=*UNICODE //OPEN-LIB LIBCCSN, *UPD //EDIT-ELEM (,LONGR,S) //END
The member ELEM1 of the library LIB1 is to be edited using the name ELEM2. The member ELEM2 already exists. Since EDIT-ELEMENT has WRITE-MODE=*CREATE by default, LMS rejects editing the member. After entering MODIFY-LMS-DEFAULTS DIALOG-CONTROL=*YES, the inquiry mechanism is activated so the user can control further LMS processing by his answer to the LMS0404 message.
/START-LMS
//OPEN-LIBRARY LIB1,*UPDATE
//EDIT-ELEM (,ELEM1,S),(ELEM=ELEM2,TYP=S)
INPUT LIBRARY= :1OSQ:$USER.LIB1
OUTPUT LIBRARY= :1OSQ:$USER.LIB1
INPUT ELEMENT= (S)ELEM1/@(0001)/2021-03-24
OUTPUT ELEMENT= (S)ELEM2/@/2021-03-24
NO CORRECT (S)ELEM1/@(0001)/2021-03-24 AS (S)ELEM2/@/2021-03-24
, OUTPUT EXISTING
//MOD-LMS-DEF DIALOG-CONTROL=*YES
//EDIT-ELEM (,ELEM1,S),(ELEM=ELEM2,TYP=S)
% LMS0522 EDIT ELEMENT (S)ELEM1/@(0001)/2021-03-24 IN LIBRARY :1OSQ:$USER.LIB1
AS ELEMENT (S)ELEM2/@/2021-03-24 IN LIBRARY :1OSQ:$USER.LIB1 ?
% LMS0404 ELEMENT ALREADY EXISTS. OVERWRITE ? REPLY (Y=YES; N=NO; A=NO AND SWIT
CH OFF DIALOG CONTROL; T=ABORT)?