System Programmer Reference › User Exits › Restore Authorization (VMBEXIT3) User Exit › FORDISK and FORDIR Authorizations

FORDISK and FORDIR Authorizations

The user exit is called with the FORDISK keyword to check a user's authorization to restore from a particular minidisk. The user exit is called with the FORDIR keyword to check a user's authorization to restore from a particular directory. CA VM:Backup calls the user exit with the FORDISK or FORDIR keywords only if FORUSER and FORDATE authorization are granted.

CA VM:Backup calls VMBEXIT3 FORDISK and FORDIR with the following arguments:

FORDISK requester suserid svaddr
FORDIR requester suserid sdir , suids...

Note: The FORUSER, FORDIR, TODISK, and TODIR argument lists are passed as multiple argument strings; in the calling argument above, the strings are shown separated by a comma. The second string of the FORDIR, TODISK, and TODIR argument lists contains a variable number of items. For details on parsing multiple argument strings, see the IBM z/VM REXX/VM Reference.

The number of strings passed with the FORUSER or FORDIR argument lists depends on whether the user is restoring CMS/SFS data or BFS data. If the user is restoring BFS data, an additional string that contains BFS-specific information is passed.

requester

Identifies the user ID initiating the restore request.

suserid

Identifies the user ID of the source user for whom the requesting user wants to restore. When the requesting user wants to restore his own data, requester is the same as suserid. When a novice user initiates a restore request, requester is always the same as suserid.

svaddr

Identifies the virtual address of a minidisk owned by the source user (suserid) from which the requesting user is attempting to restore.

sdir

Identifies the fully-qualified directory name of an SFS directory or the fully-qualified directory pathname of a BFS directory owned by the source user (suserid) from which the requesting user is attempting to restore.

Note: A pathname is considered fully qualified when /../VMBFS:filepoolid:filespaceid is specified at the start of a pathname. Because the fully-qualified directory pathname can contain blank characters, CA VM:Backup encloses the fully-qualified directory pathname in single quotes. CA VM:Backup doubles any single quotes in the pathname.

suids...

Identifies (in hex) the owning POSIX UIDs for the files backed up from the source directory (sdir). The call includes one or more suid arguments.