The MODIFY-DEFAULTS statement can be used to modify the default values. If an explicit value is used locally in an LMSCONV statement, this value has priority over the default value.
The reference to the values set here in the LMSCONV statements is the *DEFAULT specification.
At the beginning of the LMSCONV run, the values immediately following *UNCHANGED apply. If one of these values is changed using the MODIFY-DEFAULTS statement, the new setting becomes the current setting. This setting remains valid for the LMSCONV session (*UNCHANGED) until a new MODIFY-DEFAULTS statement is issued for this value.
Format
MODIFY-DEFAULTS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
ELEMENT-ATTRIBUTES = *UNCHANGED / *PARAMETERS(...)
Specifies the member type, the member version, the storage form and the file attributes.
TYPE = *UNCHANGED / *NONE / <alphanum-name 1..8>
Specifies the member type.
TYPE = *NONE
No global member type is defined, i.e. the types must be specified locally in the statements.
TYPE = <alphanum-name 1..8>
The name specified here is used as the type in the statement.
ELEMENT-VERSION = *UNCHANGED / *ALL / *HIGHEST-EXISTING
Specifies the member version for SHOW-ELEMENT-ATTRIBUTES.
ELEMENT-VERSION = *ALL
All versions for a member are output.
ELEMENT-VERSION = *HIGHEST-EXISTING
Only the highest version of a member is output.
TO-ELEMENT-VERSION = *UNCHANGED / *BY-SOURCE
Specifies the version of a target members.
TO-ELEMENT-VERSION = *BY-SOURCE
The target member contains the same version as the source member.
SOURCE-ATTRIBUTES = *UNCHANGED / *STD / *IGNORE / *KEEP(...)
Only the ADD-ELEMENT statement is interpreted.
SOURCE-ATTRIBUTES = *STD
No file attributes are stored, and neither is an ISAM key. In this case, it is only possible to add ISAM files with KEY-POSITION=5, KEY-LENGTH≤ 16 and RECORD-FORMAT=*VARIABLE to the member.
For ISAM files a warning is issued that the ISAM key has not been added.
SOURCE-ATTRIBUTES = *IGNORE
As for SOURCE-ATTRIBUTES=*STD, except that no warning is issued.
SOURCE-ATTRIBUTES = *KEEP(...)
The following file attributes are stored unchanged in the new member to be added: ACCESS-METHOD, RECORD-FORMAT, RECORD-SIZE, BUFFER-LENGTH, PERFORMANCE, USAGE, ACCESS and USER-ACCESS. If ACCESS-METHOD=ISAM is specified, the PADDING-FACTOR, LOGICAL-FLAG-LENGTH, VALUE-FLAG-LENGTH, PROPAGATE-VALUE-FLAG and the ISAM key and information relating to the ISAM secondary key are also stored. For SAM-Node-Files the character code is also stored on Net-Storage (NETCCSN).
KEEP-TYPES = *UNCHANGED / *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.
for PAM members of type X
for members of type C if KEEP-TYPES = *ALL has been specified
FILE-ATTRIBUTES = *UNCHANGED / *PARAMETERS(...)
File attributes specified when the file is created.
ACCESS-METHOD = *UNCHANGED / *ISAM / *SAM
Specifies the file access method.
ACCESS-METHOD = *ISAM
Create ISAM file.
ACCESS-METHOD = *SAM
Create SAM file.
DESTROY-DATA = *UNCHANGED / *NO / *YES / *BY-SOURCE
Defines whether or not the data is physically deleted, i.e. overwritten with X'00'.
DESTROY-DATA = *NO
A member of a library is physically deleted only if the member is marked for physical deletion or the system parameter DESTLEV requires it.
DESTROY-DATA = *YES
Any data present is physically deleted.
DESTROY-DATA = *BY-SOURCE
The flag for overwriting the data is taken from the source member or source file and assigned to the target member or target file. If the source is missing, *BY-SOURCE 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 selected value is not possible for WRITE-MODE in the local 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 specifies whether or not the execution of the statement is carried out interactively with the user. (This operand is not applicable in procedure or batch mode.)
DIALOG-CONTROL = *NO
All members are processed without query.
DIALOG-CONTROL = *YES
LMSCONV prompts for confirmation on each member, e.g. process or skip member, or abort function.
DIALOG-CONTROL = *ERROR
If a fatal error occurs during member processing, e.g. overwriting a member, the user is prompted to specify how LMSCONV should react.
The user now has the following options:
YES | Process the member. |
NO | Do not process the member. |
ALL | Abort the statements without prompting. |
TERMINATE | Terminate the statement. |
By pressing the K2 key and entering “/INFORM-PROGRAM”, the user can modify the value of the DIALOG-CONTROL operand. If LMSCONV is in the middle of member processing, the user can influence the further processing with:
/INFORM-PROGRAM '[N-I / N-E / C][,DIALOG-CONTROL=*NO / *YES / *ERROR]'
/INFORM-PROGRAM 'NEXT-INPUT (N-I)': the current statement is aborted;
LMSCONV reads a further statement as soon as it becomes active again. An unrecognized or missing text has the same effect as NEXT-INPUT.
/INFORM-PROGRAM 'NEXT-ELEMENT (N-E)': the processing of the current member in the current statement is aborted; LMSCONV continues processing with the next member (if available). If no next member is present, NEXT-ELEMENT has the same effect as NEXT-INPUT.
/SEND-MSG 'CONTINUE (C)':LMSCONV processing is continued as normal
C,NO | The member is to be processed, but interactive mode not activated. |
N-E/N-I,NO | Member or statement processing is to be aborted, but interactive mode not activated. |
C,YES/ERROR | The member is to be processed and interactive mode then activated. |
N-E/N-I,YES/ERROR | Member or statement processing is to be aborted and interactive mode then activated. |
DIALOG-CONTROL with /INFORM-PROGRAM applies only to the current statement.INFORMATION = *UNCHANGED / *MEDIUM / *MINIMUM / *MAXIMUM / *SUMMARY
This parameter defines the scope of directory information to be output.
INFORMATION = *MEDIUM
Outputs the type, name, version, variant number and the date or the member size.
INFORMATION = *MINIMUM
Outputs only the type, name and version.
INFORMATION = *MAXIMUM
In addition to the type, name, version, variant number and the user date, the existing member protection, the storage form, the assigned character set, as well as the user date, creation date and modification date and time are logged for all members.
INFORMATION = *SUMMARY
Outputs only the number of members per type.
LAYOUT = *UNCHANGED / *VARIABLE / *FIXED
This parameter defines the format of the directory to be output.
LAYOUT = *VARIABLE
The number of print columns depends on the longest member designation within a member type.
LAYOUT = *FIXED
The directory is printed in a single column in fixed format. Single column means that the entries in the directory appear one beneath the other.
SORT = *UNCHANGED / *BY-NAME / *BY-VERSION / *BY-USER-DATE / *BY-SECONDARY-NAME
Sort criterion for the directory entries of the selected members. The type is always used as the first sort criterion.
SORT = *BY-NAME
The directory entries of the selected members are sorted on the basis of the following sequence: type, name and version.
SORT = *BY-VERSION
The directory entries of the selected members are sorted on the basis of the following sequence: type, version and name.
SORT = *BY-USER-DATE
The directory entries of the selected members are sorted on the basis of the following sequence: type, user date, name and version.
SORT = *BY-SECONDARY-NAME
The directory entries of the selected members are sorted on the basis of the following sequence: type, secondary name, secondary attribute, name and version.
For more detailed information, refer to the SHOW-ELEMENT-ATTRIBUTES statement.
OUTPUT-FORM = *UNCHANGED / *STD / *CHARACTER / *HEXADEZIMAL / *DUMP
Specifies the display format for the output.
OUTPUT-FORM = *STD
The form of representation is selected dependent on the member type.
OUTPUT-FORM = *CHARACTER
The output is in alphanumeric form.
OUTPUT-FORM = *HEXADECIMAL
The output is in alphanumeric and hexadecimal form, one above the other.
OUTPUT-FORM = *DUMP
The output is in alphanumeric and hexadecimal form, side by side. For member types S, P, D, J and M, this operand has the same effect as OUTPUT-FORM=*HEXADECIMAL.
DELETE-SOURCE = *UNCHANGED / *NO / *YES
Here, the user can specify whether the original file is to be retained (default value *NO) or deleted (parameter *YES). This operand has no effect when read by *OMF.
MAX-ERROR-WEIGHT = *UNCHANGED / *SERIOUS / *SIGNIFICANT / *RECOVERABLE
This operand defines the cases in which LMSCONV is to trigger the spin-off mechanism.
MAX-ERROR-WEIGHT = *SERIOUS
The spin-off mechanism is triggered for serious errors, i.e. errors for which processing of the statement is no longer possible or useful.
MAX-ERROR-WEIGHT = *SIGNIFICANT
The spin-off mechanism is triggered for *SERIOUS and also for other errors (except when the member could not be found or overwritten).
MAX-ERROR-WEIGHT = *RECOVERABLE
The spin-off mechanism is triggered for all errors.
RUN-MODE = *UNCHANGED / *STD / *BATCH
When LMSCONV is running in interactive mode, this operand determines whether LMSCONV should continue to 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
LMSCONV shall continue to run normally.
RUN-MODE = *BATCH
LMSCONV shall behave like running in batch mode.
NEXT-ATTEMPT = *UNCHANGED / *NO / *YES(...)
Controls the open attempts for file, type or member lock in procedure or batch mode.
NEXT-ATTEMPT = *NO
No further attempts to open are made.
NEXT-ATTEMPT = *YES(...)
Further attempts to open are made.
NUMBER-OF-ATTEMPTS = *UNCHANGED / <integer 1..2147483647>
Number of further attempts (default: 9 attempts).
PERIOD = *UNCHANGED / <integer 1..21599>
Wait period between attempts in seconds (default: 6 seconds).
TEXT-INFORMATION = *UNCHANGED / *ALL / *STATISTICS / *FILE-ATTRIBUTES / *PARAMATERS(...)
Defines the information scope for all members except member types R, C and L. For PAM members, all values have the same effect as *ALL, except for *FILEATTRIBUTES.
TEXT-INFORMATION = *ALL
Everything is output.
TEXT-INFORMATION = *STATISTICS
The number of records per record type and the total number of records are output.
TEXT-INFORMATION = *FILE-ATTRIBUTES
Only the stored file attributes are output.
TEXT-INFORMATION = *PARAMETERS(...)
Defines a member extract to be output.
INFORMATION = *UNCHANGED / *ALL / list-poss(2): *TEXT / *COMMENT
The member section to be output.
INFORMATION = *ALL
Outputs all user record types.
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
Processes all user record types.
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>
Beginning of the range, specified by the first record number. Record number 1 is the default value.
TO = *UNCHANGED / *LAST / <integer 1..2147483647>
End of the range, specified by the last record number. The last record number is used as the default value.
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..32764>
Beginning of the record part, specified by the first character in the record. The first character is used as the default value.
LENGTH = *UNCHANGED / *REST / <integer 1..32764>
Length of the record part. The remainder of the record is used as the default value.
RECORD-NUMBER = *UNCHANGED / *BY-OUTPUT / *YES / *NO
Specifies output of the record numbers.
RECORD-NUMBER = *BY-OUTPUT
Only if the output is directed to SYSOUT will no record numbers be output. With any other output medium, the record numbers are included in the output.
RECORD-NUMBER = *YES
The record numbers are also output to SYSOUT.
RECORD-NUMBER = *NO
No record numbers are included in the output..
MODULE-INFORMATION = *UNCHANGED / *ALL / *STATISTICS / *PARAMETERS(...)
Defines the information scope for object modules (R-type members).
MODULE-INFORMATION = *ALL
Everything is output.
MODULE-INFORMATION = *STATISTICS
The name, length and address of the CSECTS and also the overall length of the module are output.
MODULE-INFORMATION = *PARAMETERS(...)
This parameter determines whether all record types or only selected record types are output.
INFORMATION = *UNCHANGED / *ALL / *TXT(...) / *TXTP(...) / list-poss(9): *ESD / *ISD / *LSD / *RLD / *REP / *INCLUDE / *DSDD / *REF / *END
The record types listed here can be selected.
INFORMATION = *TXT(...)
Text records are selected.
CSECT-NAME = *UNCHANGED / *ALL / <c-string 1..32 with-low> / <text 1..32>
The text records can be restricted to one 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(...)
TXTP records are output.
MODIFICATION-ID = *UNCHANGED / *ALL / <c-string 1..8 with-low> /*RANGE(...)
Those TXTP records with the specified identification are selected.
MODIFICATION-ID = *RANGE(...)
A group of TXTP records lying in a range can be selected.
FROM = *UNCHANGED / *LOWEST / <c-string 1..8 with-low>
The beginning of the range is by default the lowest identification for the TXTP records, otherwise the value entered here.
TO = *UNCHANGED / *HIGHEST / <c-string 1..8 with-low>
The end of the range is by default the highest identification for the TXTP records, otherwise the value entered here.
PHASE-INFORMATION = *UNCHANGED / *ALL / *STATISTICS / *PARAMETERS(...)
Defines the information scope for phases (C-type members).
PHASE-INFORMATION = *ALL
Everything is output.
PHASE-INFORMATION = *STATISTICS
The name, length and address of the segment and also the overall length of the segment are output.
PHASE-INFORMATION = *PARAMETERS(...)
This parameter determines whether all record types or only selected record types are output.
SEGMENT = *UNCHANGED / *ALL / *ROOT / <name 1..8>
Phase segment that is selected.
INFORMATION = *UNCHANGED / *ALL / *TXT(...) / *TXTP(...) / list-poss(4): *ESD / *ISD / *LSD / *RLD
The record types listed here can be selected.
INFORMATION = *TXT(...)
Text records are selected.
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(...)
TXTP records are output.
MODIFICATION-ID = *UNCHANGED / *ALL / <c-string 1..8 with-low> /*RANGE(...)
Those TXTP records with the specified identification are selected.
MODIFICATION-ID = *RANGE(...)
A group of TXTP records lying in a range can be selected.
FROM = *UNCHANGED / *LOWEST / <c-string 1..8 with-low>
The beginning of the range is by default the lowest identification for the TXTP records, otherwise the value entered here.
TO = *UNCHANGED / *HIGHEST / <c-string 1..8 with-low>
The end of the range is by default the highest identification for the TXTP records, otherwise the value entered here.
LLM-INFORMATION = *UNCHANGED / *ALL / *STATISTICS / PARAMETERS(...)
Defines the information scope for link and load modules (L-type members).
LLM-INFORMATION = *ALL
Everything is output.
LLM-INFORMATION = *STATISTICS
General information on the link and load module (name, copyright, ...) is output.
LLM-INFORMATION = *PARAMETERS(...)
This parameter determines whether all record types or only selected record types are output.
LLM-PART = *UNCHANGED / *ALL / *SLICE(...) / *SUB-LLM(...)
Specifies the LLM part to be selected. By default the entire LLM is 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>
The sub-LLM to be output is determined by way of its path name.
INFORMATION = *UNCHANGED / *ALL / *TXT(...) / *TXTP(...) / *LOGICAL(...) / *PHYSICAL / *REF / list-poss(3): *ESVD / *ESVR / *LRLD / *RELOCATION
The record types listed here can be selected.
INFORMATION = *TXT(...)
Text records are selected.
CSECT-NAME = *UNCHANGED / *ALL / <c-string 1..32 with-low> / <text 1..32>The text records can be restricted to one 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(...)
TXTP records are output.
CSECT-NAME = *UNCHANGED / *ALL / <c-string 1..32 with-low> / <text 1..32>
The TXTP records can be restricted to one CSECT.
MODIFICATION-ID = *UNCHANGED / *ALL / <c-string 1..12 with-low> / *RANGE(...)
Those TXTP records with the specified identification are selected.
MODIFICATION-ID = *RANGE(...)
A group of TXTP records lying in a range can be selected.
FROM = *UNCHANGED / *LOWEST / <c-string 1..12 with-low>
The beginning of the range is by default the lowest identification for the TXTP records, otherwise the value entered here.
TO = *UNCHANGED / *HIGHEST / <c-string 1..12 with-low>
The end of the range is by default the highest identification for the TXTP records, otherwise the value entered here.
INFORMATION = *LOGICAL(...)
Outputs the logical structure of the LLM.
LEVEL= *UNCHANGED / *ALL / *NEXT
Outputs all substructures by default; otherwise, only the next substructure.
INFORMATION = *PHYSICAL
Outputs the physical structure of the LLM.
Example
The file TEST1 is to be added as member of type D in the library LIB3.
The default setting for the member type is changed to the desired value using the MODIFY-DEFAULTS statement. Thus, it is no longer necessary to specify the member type in the subsequent ADD-ELEMENT statement. To ensure that LMSCONV can confirm successful addition of the files, the MODIFY-LOGGING-PARAMETERS statement sets the scope of the log information to the complete LMSCONV log.
/start-lmsconv
//open-library lib3,*update
//modify-defaults type=d
//modify-log-param logging=*maximum
//add-element test1
INPUT FILE
OUTPUT LIBRARY= :N:$USER.LIB3
ADD TEST1 AS (D)TEST1/ (0001)/<date>
. . .