MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 6 247
Command Definitions (FLUSHLOG-GETUSERMODE)
FPARSE
FPARSE
NM and CM callable.
Parses and validates file designators. Only MPE syntax names can be parsed. Escaped or
POSIX syntax names will return errors.
Syntax
CA I16A U16A I32A
FPARSE(
formaldesig,result , item,vector );
Parameters
formaldesig character array (required)
Passes the file reference string to be parsed. Terminate the string with any
nonalphanumeric character except a slash (/), period (.), or colon (:).
If an error occurs, the first element of the
vector array returns the byte
offset of the invalid item in
formaldesig .
result 16-bit signed integer array (required)
Returns two elements; the first element is the error number, the second
element is reserved and always returns 0.
A positive value indicates the syntax of the specified file reference is
correct and what type of file reference is being made. A negative value
indicates a syntax error in the file reference.
The possible error number values are:
Value Meaning
0 Regular file designator
1 Backreference (* is the first character in
formaldesig )
2 System file ($ is the first character in
formaldesig )
The default designator numbers for system files, as defined for FOPEN
foption , are:
0 File name
1 $STDLIST
2 $NEWPASS
3 $OLDPASS
4 $STDIN
5 $STDINX
6 $NULL