Deregister File System (QHFDRGFS) API


  Required Parameter Group:

1 File system name Input Char(10)
2 Error code I/O Char(*)

  Threadsafe: No

The Deregister File System (QHFDRGFS) API removes a file system and its functions from HFS support so that applications can no longer work with the file system through the HFS APIs. You can use the QHFDRGFS API to keep users from working with a file system while you upgrade to a new release.

If there are open files or directories in the file system being deregistered, HFS support automatically closes them before deregistering the file system. See End Job Session Exit Program for details.


Authorities and Locks

None.


Required Parameter Group

File system name
INPUT; CHAR(10);

The name of the file system being deregistered.

Note: You cannot deregister the document library services (DLS) file system, QDLS.

For deregistration to succeed, the file system cannot be in use. If a job that called the file system is not yet complete, the file system's Start Job Session exit program is still locked on behalf of that job, and the file system is still in use.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Error Messages

Message ID Error Message Text
CPF1F41 E Severe error occurred while addressing parameter list.
CPF1F52 E Error code not valid.
CPF1F81 E API specific error occurred.
CPF1F85 E Not authorized to file system &1.
CPF1F87 E Missing or damaged exit program &2.
CPF1F9B E Reregister or deregister file system failed.
CPF1F92 E File system &1 not registered.
CPF1F97 E File system &1 in use.
CPF1F98 E Registration or deregistration cannot be done now.
CPF3C90 E Literal value cannot be changed.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.


API introduced: V2R1

[ Back to top | Hierarchical File System APIs | APIs by category ]