Set Directory (17)

Set Directory (17)

The Set Directory operation (B_SET_DIR) sets the current directory to a specified path name.


	Op Code	Pos Block	Data Buf	Data Buf Len	Key Buffer	Key Number
Sent
Returned

The target logical disk drive and directory must be accessible.

1

Set the operation code to 17.

2

Store the logical disk drive and directory path, terminated by a binary 0, in the key buffer. If you omit the drive name, the MicroKernel Engine uses the default drive. If you do not specify the complete path for the directory, the MicroKernel Engine appends the directory path specified in the key buffer to the current directory.

For details about path names supported by PSQL clients, see Network Path Formats Supported by PSQL Requesters in Getting Started With PSQL.

If the Set Directory operation is successful, the MicroKernel Engine makes the directory specified in the key buffer the current directory.

If the Set Directory operation is unsuccessful, the MicroKernel Engine leaves the current directory unchanged and returns a nonzero status code.

The Set Directory operation has no effect on positioning.