osi_mountstatus — Report file system status to LFS

Function

The osi_mountstatus service is used by a PFS to indicate to the LFS a change in the status of a file system, such as completion of an asynchronous mount operation.

Requirements

Operation	Environment
Authorization:	Problem or supervisor state; any PSW key
Dispatchable unit mode:	Task or SRB
Cross memory mode:	Any
AMODE:	31-bit
ASC mode:	Any
Interrupt status:	Enabled for interrupts
Locks:	Unlocked
Control parameters:	All parameters must be addressable by the caller and in the primary address space.

Format

     osi_mountstatus(Entry_code,
                     StDev,
                     Return_value,
                     Return_code,
                     Reason_code);

Parameters

Entry_code

Supplied parameter

Type:: Integer
Length:: Fullword

Entry_code specifies the function that is being requested for the osi_mountstatus service.

Entry_code	Explanation
OSI_MOUNTCOMPLETE	Mount complete

StDev

Supplied parameter

Type:: Integer
Length:: Fullword

This is a copy of MTAB.mt_stdev that is passed by the LFS on the original vfs_mount. It identifies the file system for which status is being reported.

Return_value

Returned parameter

Type:: Integer
Length:: Fullword

The name of a fullword in which the osi_mountstatus service returns the results of the operation, as one of the following:

Return_value: Meaning
-1: The operation was not successful.
0: The operation was successful.

Return_code

Returned parameter

Type:: Integer
Length:: Fullword

The name of a fullword in which the osi_mountstatus service stores the return code. The osi_mountstatus service can return the following value in the Return_code parameter only if Return_value is -1. Reason_code further qualifies the Return_code value.

Return_code	Explanation
EINVAL	Parameter error. Consult Reason_code to determine the exact reason the error occurred. The following reason codes can accompany the return code: JRIsMounted, JRBadStDev.

Reason_code

Returned parameter

Type:: Integer
Length:: Fullword

A fullword in which the osi_mountstatus service stores the reason code. The osi_mountstatus service returns Reason_code only if Return_value is -1. Reason_code further qualifies the Return_code value.

Usage notes

For the OSI_MOUNTCOMPLETE Entry_code:
- The PFS uses this entry code to inform the LFS of the completion of a mount operation that was previously identified as asynchronous. The LFS calls vfs_mount again to complete the mount. See Asynchronous mounting.
- If the PFS has a Return_value, Return_code, and Reason_code to present, indicating the status of the mount, they must be returned to the LFS at the time vfs_mount is called again.
The address of the osi_mountstatus routine is passed to the PFS in the OSIT when the PFS is initialized.