MPE/iX Intrinsics Reference Manual (32650-90905)

344 Chapter7
Command Definitions (HP32208-HPLOACNMPROC)
HPDEVCREATE
HPDEVCREATE
Provides an application interface to create a streams, fifo, and device link file.
Syntax
CA I32V I32V
HPDEVCREATE(
pathname , path_syntax , path_length , status ,
I32V
[,
itemnum , item ] [...]);
Parameters
pathname 32-bit pointer to a packed array of characters (required)
The name of the device file to be created. If the
path_length does not
indicate the length of the
pathname , the device file name is assumed to be
terminated with a null.
path_syntax 32-bit integer by value (optional)
Indicates the syntax of the name in the
pathname parameter. The valid
values are:
0 MPE Escaped Syntax
1 MPE Only Syntax
2 POSIX Syntax
A value other than those listed above results in an error. The default value
is 0 (MPE escaped syntax). MPE escaped syntax allows a name to be
expressed in either MPE or POSIX syntax.
path_length 32-bit integer by value (optional)
Indicates the length of the name in the
pathname parameter. A positive
value is taken as the exact length of the name, excluding any terminating
characters.
If an invalid character is found in the
pathname , an error is returned.
Passing a -1 value indicates that the length of the name is unknown.
HPDEVCREATE parses the name in the
pathname parameter until it finds
either a terminating character, an invalid character, or the name is 1023
characters. Passing a value of zero indicates a null or empty name will
result in an error. Passing a negative value other than -1 will result in an
error.
Default is -1.
status 32-bit integer by reference (optional)
Returns an indication of the success or failure of the intrinsic call.