Loads an extract file, optionally associating it
with an executable module.
.-ASMLANGX--.
>>-LANguage--LOAd--extract-file-name--+-----------+------------->
'-file-type-'
.-*---------.
>--+-----------+--+------------------------+-------------------><
'-file-mode-' '-(--MODUle--module-name-'
- extract-file-name
- The extract file that is loaded.
- On CMS, the file name (FN) of the extract file created by ASMLANGX.
- On z/OS, the PDS member name
of the extract file created by ASMLANGX.
For z/OS sequential files (DSORG(PS)), a dummy name must be specified,
but is ignored.
- On z/VSE, the librarian member name of the extract file created by
ASMLANGX.
If not specified (the file type default accepted)
IDF uses the entries in the XPATH to locate the extract file.
- ASMLANGX
- The default file type for extract file (normally not specified).
- file-type
- The file type of the extract file.
- On CMS, the file type (FT) of the extract file created by ASMLANGX.
- On z/OS, the DD name allocated to the extract file created by
ASMLANGX.
- On z/VSE, not used.
- file-mode
- The file mode of the extract file.
- On CMS, the FM of the extract file created by ASMLANGX.
- On z/OS, not used, ignored if specified.
- On z/VSE, not used, ignored if specified.
- *
- Indicates that all disks are to be searched in order.
- MODULE
- Indicates that a module name is being specified.
- module-name
- The module with which to associate the extract file.
Multiple instances of the same extract file may be loaded as long as
each specifies a different module-name.
If a module is
not specified:
- If the extract file contains information that needs load-time
resolution the module
defaults to the qualified target module.
- Otherwise, the extract file is generic, where it is
freely associated with any relevant code sections in all MODULES.
The LANGUAGE STATUS command (see LANGUAGE STATUS)
shows the
module name specified when an extract file is loaded.
The MAP command (see MAP) shows the association
between extract files and program code sections.
Return codes
- 0
- Operation successful.
- 1
- Missing keyword.
- 2
- Keyword truncated.
- 3
- Keyword unknown.
- 28
- File not found.
- 29
- File was already loaded with the same module specification.
- 201
- The input file is from a version of ASMLANGX that is not
supported by the LSM.
- 202
- Duplicate or invalid scope record in input file.
- 203
- More source statements in file than indicated by
the scope record.
- 204
- Duplicate or invalid number-of-symbol record in the input file.
- 205
- Symbol id number larger than maximum symbol number was encountered
in a symbol record.
- 206
- Symbol id number larger than maximum symbol number was encountered
in an array record.
- 207
- File contains no records of a known format.
- 208
- Duplicate or invalid check record in the input file.
- 209
- Duplicate or invalid address expression record in the input file.
- 210
- Duplicate or invalid structure layout record in the input file.
- 211
- Symbol id number larger than maximum symbol number was encountered
in a respecify record.
- 212
- Address expression id number larger than maximum address expression
number or symbol id number larger than the maximum symbol number was
encountered in an address expression record.
- 213
- Address expression id number larger than maximum address expression
number or symbol id number larger than the maximum symbol number was
encountered in an address expression respecify record.
- 214
- Symbol id number larger than maximum symbol number was encountered
in a symbol optimization record.
- 215
- Symbol id number larger than maximum symbol number was encountered
in a structure layout record.
- 216
- Errors were encountered unpacking a source record.
- 217
- Base debugger (IDF) version is too low to support the required
function.
- 218
- Module private-code CSECT was not found.
The functions in the extract file cannot be located in the IDF
symbol table.
- 219
- Scope ID record present, but it was not preceded by a Scope record.
- 220
- Symbol id number larger than maximum symbol number was encountered
in a scope ID record.
- 221
- Duplicate or invalid CSECT record in the input file.
- 222
- CSECT record expected but not found in the input file.
- 223
- CSECT id number larger than maximum CSECT number was encountered in
a PC (Private Code) lookup record.
- 224
- CSECT id number larger than maximum CSECT number was encountered in
a source record.
- 225
- CSECT id number larger than maximum CSECT number was encountered in
a symbol record.
- 226
- Symbol id number larger than maximum symbol number was encountered
in a constant record.
- 227
- Error occurred building the statement offset table.
- 237
- Duplicate or invalid On Event Map record in the input file.
- 238
- Duplicate or invalid Secondary Entry Point record in the input
file.
- 239
- Symbol id number larger than maximum symbol number was encountered
in a Secondary Entry Point record.
- 240
- Duplicate or invalid External Symbol List record in the input file.
- 241
- Symbol id number larger than maximum symbol number was encountered
in an External Symbol List record.
- 242
- Duplicate or invalid Symbol Display Format record in the input
file.
- 243
- Symbol id number larger than maximum symbol number was encountered
in a Symbol Display Format record.
- 244
- Duplicate or invalid Class Layout record in the input file.
- 245
- Symbol id number larger than maximum symbol number was encountered
in a Class Layout record.
- 246
- Duplicate or invalid Class Hierarchy record in the input file.
- 247
- Symbol id number larger than maximum symbol number was encountered
in a Class Hierarchy record.
- 248
- Symbol id number larger than maximum symbol number was encountered
in an OverLoaded Symbol record.
- 249
- Duplicate or invalid Linkage Convention record in the input file.
- 250
- Symbol id number larger than maximum symbol number was encountered
in a Linkage Convention record.
- 251
- Symbol id number larger than maximum symbol number was encountered
in a Parameter List record.
- 252
- Duplicate or invalid Compile Information record in the input file.
- 253
- Duplicate or invalid OverLoaded Entry Stmt record in the input file.
- 254
- Symbol id number larger than maximum symbol number was encountered
in an Overloaded Entry Stmt record.
1xxx
Error occurred during scan of the extract file.
The values for xxx are:
- 1yy
- yy is the RC from File_Open
- 2yy
- yy is the RC from File_Read
- 4yy
- yy is the RC from File_Point
- 5yy
- yy is the RC from Mem_Allocate
- 6yy
- yy is the RC from Mem_Free
- 7yy
- yy is the RC from File_Close
- 8yy
- yy is the RC from File_Note