HPDEVCREATE

Syntax

               CA        I32V         I32V         I32
  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.

• If no errors or warnings occur, status returns 32-bits of zero.

• If errors or warnings occur, status is interpreted as two 16-bit fields:

  Bits (0:16)

  Comprise status.info. A negative value indicates an error condition, and a positive value indicates a warning condition.

  Bits (16:16)

  Comprise status.subsys. The value represents the subsystem that sets the status information. For HPDEVCREATE intrinsic, the subsystem is File System (143).

  If the status parameter is not specified and an error occurs during the processing of HPDEVCREATE call, the calling process aborts.

keyword#

32-bit integer by value (optional)

Specifies a keyword value used in combination with the corresponding keyvalue parameter. Specifies the type of device file options used to create a device file. Up to 32 keyword/keyvalue pairs may be specified in a call to HPDEVCREATE. The following table lists the defined keyword/keyvalue pairs. Specifying a keyword other than those below will result in a error.

• If duplicate keywords are specified in a call to HPDEVCREATE, the last keyvalue is used, and a warning is returned to the caller.

• If no keyword/keyvalue pairs are specified, an error is returned.

keyvalue#

Type varies by reference (optional)

The keyvalue parameter is matched with its corresponding keyword to pass information to HPDEVCREATE. If a keyword is specified and the keyvalue is not present, an error will occur.

Table 7-12 HPDEVCREATE Keywords/keyvalues

   %linkname% (% is the delimiter)

   (X:@.@;R,W:JOE.SYS;RACD:SUE.SMITH)<cr>

Operation Notes

Related Information