User`s guide

BDOS FUNCTION 152: PARSE FILENAME

Entry Parameters:

Registers C: 98H

DE: PFCB Address

Returned Value:

Parsed file control block

The Parse Filename function parses an ASCII file specification and prepares a File

Control Block, FCB. The calling program passes the address of a data structure called

the Parse Filename Control Block, PFCB, in register pair DE. The PFCB contains the

address of the input ASCII filename string followed by the address of the target FCB

as shown below:

PFCB: DW INPUT ; Address of input ASCII string

DW FCB ; Address of target FCB

The maximum length of the input ASCII string to be parsed is 128 bytes. The target

FCB must be 36 bytes in length.

Function 152 assumes the input string contains file specifications in the following

form:

{d:}filename{.typll}{;password}

where items enclosed in curly brackets are optional. Function 152 also accepts iso-

lated drive specifications d: in the input string. When it encounters one, it sets the

filename, filetype, and password fields in the FCB to blank.

3-96

BDOS Function Calls CP/M 3 Programmers Guide