Data Queue APIs--Categories - FTP Directory Listing - IBM

Move Folder to ASP (QHSMMOVF) API
Move Folder to ASP (QHSMMOVF) API
Required Parameter Group:
1 Folder name Input Char(12)
2 Target auxiliary storage pool (ASP) Input Binary(4)
3 Error code I/O Char(*)
The Move Folder to ASP (QHSMMOVF) API moves a root folder and its contents from its existing
auxiliary storage pool (ASP) to the specified target ASP through a save and restore process. The API,
however, will retain private authorities to the objects that would normally be lost with a save and restore
operation.
Restrictions
The Move Folder to ASP (QHSMMOVF) API has the following restrictions:
● The folder must be a root folder and will be moved as such.
● The folder and its contents must not be in use by other jobs.
●
●
●
●
●
●
●
●
Folders that were restored using the Restore Licensed Program (RSTLICPGM) should not be
moved.
After the root folder has been moved, the following parameters are changed:
❍ The date last used will be set to blank.
❍ The change date and time will be set to the current date and time.
❍ The days used count will be set to zero.
❍ The days used count reset will be set to blank.
❍ The save date/time and restore date/time will be updated.
The target ASP must have enough space for the folder and its objects in order for the API to
perform the move action.
The target ASP must be either the system ASP, a library-type ASP, or an empty ASP.
The user must be enrolled in the system distribution directory.
Access codes are the responsibility of the user and will be lost.
A root folder that contains documents checked out or saved with STG(*FREE) will not be moved.
A root folder that contains more than 99 subfolders will not be moved.
Authorities and Locks
See Lock Conditions When Saving and Restoring Objects in the Backup and Recovery book for detailed
information on locks that are applied to objects during save operations.
http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/qhsmmovf.htm (1 of 3) [10/4/1999 2:36:05 PM]