must also be X'02'. When using BALR, the calling program can determine the
entry point it wants by usingSUBCOM. In this case, register 1 points to the FSCB
and register 2 points to the SCBLOCK. The address of the the SCBLOCK has
been returned fromSUB COM. The routines available, their entry point names, and error return codes are:
DMSXFLST -This routine returns the characteristics of a file (RECFM,
LRECL, etc). It also ensures that the file is in the XED IT ring. The return
codes are:
o File is in the XED IT ring
24 Incomplete fileid specified
28 File is not in the XEDIT ring
Note: Return codes are similar to those for ESTATE.
DMSXFLRD -This routine transfers one record from XEDIT storage to the
calling program. IfRECFlVI=F, it may transfer more than one record. The
return codes are:
o READ performed
1 File is not in the XEDIT ring
2 Invalid buffer address
5 Number of items equals zero
7 RECFM is not 'F' or'V' 8 Buffer is too small (Records truncated)
11 Number of items is not equal to one for V-file
12 End of file
Note: Return codes are similar to those for FSREAD.
DMSXFL WR -This routine transfers one record from the calling program to
XEDIT storage. If RECFM=F, it may transfer more than one record. The
return codes are:
o WRITE performed
2User buffer address equals zero
7 Skip over unwritten records
8 Number of bytes is not specified
11 RECFM is not 'F' or'V' 13 No more space is available
14 Number of bytes is not integrally divisible by the number of item
15 Item length is not the same as previous
16 RECFM of 'F' or'V' is not the same as previous
18 Number of items is not equal to one for V-file
28 File is not in the XEDIT ring
Note: Return codes are similar to those for FSWRITE.DMSXFLPT - This routine moves the current line pointer to a record specified
by the calling program. The return codes are:
oPOINT performed
1 File not found
2 Invalid FSCB
Functional Infonnation 349
entry point it wants by using
and register 2 points to the SCBLOCK. The address of the the SCBLOCK has
been returned from
DMSXFLST -This routine returns the characteristics of a file (RECFM,
LRECL, etc). It also ensures that the file is in the XED IT ring. The return
codes are:
o File is in the XED IT ring
24 Incomplete fileid specified
28 File is not in the XEDIT ring
Note: Return codes are similar to those for ESTATE.
DMSXFLRD -This routine transfers one record from XEDIT storage to the
calling program. If
return codes are:
o READ performed
1 File is not in the XEDIT ring
2 Invalid buffer address
5 Number of items equals zero
7 RECFM is not 'F' or
11 Number of items is not equal to one for V-file
12 End of file
Note: Return codes are similar to those for FSREAD.
DMSXFL WR -This routine transfers one record from the calling program to
XEDIT storage. If RECFM=F, it may transfer more than one record. The
return codes are:
o WRITE performed
2
7 Skip over unwritten records
8 Number of bytes is not specified
11 RECFM is not 'F' or
14 Number of bytes is not integrally divisible by the number of item
15 Item length is not the same as previous
16 RECFM of 'F' or
18 Number of items is not equal to one for V-file
28 File is not in the XEDIT ring
Note: Return codes are similar to those for FSWRITE.
by the calling program. The return codes are:
o
1 File not found
2 Invalid FSCB
Functional Infonnation 349