The mount callable service mounts a file system, making the files in it available for use.
Operation | Environment |
---|---|
Authorization: | Supervisor state or problem state, any PSW key |
Dispatchable unit mode: | Task |
Cross memory mode: | PASN = HASN |
AMODE: | 31-bit |
ASC mode: | Primary mode |
Interrupt status: | Enabled for interrupts |
Locks: | Unlocked |
Control parameters: | All parameters must be addressable by the caller and in the primary address space. |
|
The name of a fullword that contains the length of MountPoint_name.
The name of a field that contains the name of the mount point. The length of this field is specified in MountPoint_length.
The name of a 44-character field that identifies the file system to be mounted. The name must be left-justified and padded with blanks.
The name of a field that contains the 8-character file system type. This corresponds to the type of file system that was defined by a FILESYSTYPE parameter of the BPXPRMxx parmlib member.
This parameter is mapped by the macro BPXYMTM; see BPXYMTM — Map the modes for mount and unmount for details.
The name of a fullword that contains the length of the file system-specific parameters (Parm). The maximum length is 500 bytes.
The name of a field, of length Parm_length, that contains the file-system-specific parameters. These have a maximum of 500 bytes.
The name of a fullword in which the mount service returns 0 or 1 if the request is successful, or -1 if it is not successful. A Return_value of 1 indicates that the mount will complete asynchronously.
Return_code | Explanation |
---|---|
EBUSY | The file system to mount is quiesced; or no more locks are available. The following reason codes can accompany the return code: JROutOfLocks, JRQuiesced. |
EINVAL | There was a parameter error. Verify the Mount_mode and File_system_type.
Other reasons for this error include:
|
EIO | An I/O error occurred. |
ELOOP | A loop exists in symbolic links that were encountered during resolution of the Pathname argument. This error is issued if more than 24 symbolic links are detected in the resolution of Pathname. |
ENOENT | The mount point does not exist. The following reason code can accompany the return code: JRMountPt. |
ENOMEM | There is not enough storage space available to mount this file system. |
ENOTDIR | The mount point is not a directory. The following reason code can accompany the return code: JRMountPt. |
EPERM | Insufficient authority to do the mount. |
The name of a fullword in which the mount service stores the reason code. The mount service returns Reason_code only if Return_value is -1. Reason_code further qualifies the Return_code value. For the reason codes, see z/OS UNIX System Services Messages and Codes.
For an example using this callable service, see BPX1MNT (mount) example.