{
{   The purpose of this request is to validate and establish maintenance
{ access to an element in NOS/VE's active configuration.  The reason for
{ requesting maintenance access to an element is to ensure that the
{ installation management or operator have authorized online maintenance to be
{ performed before it is attempted.  Maintenance access must be requested and
{ obtained before the element can be used by a maintenance job.  Once
{ maintenance access has been granted to an element, the element cannot be
{ reserved to a job until maintenance access has been terminated.  The term
{ "reserved" implies that the use of the cmp$reserve_element request by a job
{ to acquire sole use of an element; the system cannot permit maintenance
{ access to a reserved element because the system does not control access to
{ an element once it has been reserved to a job.  Elements scheduled to a job
{ using the RESERVE_RESOURCE command may be the object of maintenance access.
{ The term "assigned" refers to the action taken by an operator using the
{ ASSIGN_DEVICE command.
{
{   For CONCURRENT access to be granted:
{
{       1.  The element must be in the active configuration.
{
{       2.  The element must not be reserved nor assigned to any job.
{
{       3.  The element must not currently be the object of DEDICATED
{           maintenance access.
{
{       4.  The element must be in the ON or DOWN state.
{
{       5.  If the element is a disk controller which has more than one
{           channel connected to it and the channels cannot be used
{           concurrently and independently, then the channel to be used
{           for concurrent maintenance must be the channel that is
{           currently being used by NOS/VE.
{
{   For DEDICATED access to be granted:
{
{       1.  The element must be in the active configuration.
{
{       2.  The element must not be reserved nor assigned to any job.
{
{       3.  The element must not currently be the object of CONCURRENT
{           maintenance access.
{
{       4.  The element must not currently be the object of DEDICATED
{           maintenance access.
{
{       5.  The element must be in the DOWN state.
{
{       6.  The element must not be system-critical (i.e.  required for
{           continued system execution).
{
{       7.  If the element has channel(s) on its upline connection then :
{
{          a.  If the element is described in the active configuration as
{              being connected to another mainframe, the operator will be
{              asked to validate that the element is either DOWN, OFF or
{              unconfigured with respect to other mainframes.
{
{          b.  In a dual-state system, if the element is described in the
{              active configuration as being connected to the mainframe making
{              this request, then this request will attempt to acquire all
{              channels from the real-state system which are described in the
{              active configuration for the element.  Failure to acquire
{              all the necessary channels from the real-state system will
{              prevent the reservation of the element.  If the channels are
{              acquired, they will be returned to the real-state system when
{              the NOS/VE DEDICATED access to the element is released.
{
{       MSP$REQUEST_MAINTENANCE_ACCESS (ELEMENT, ACCESS, STATUS)
{
{ ELEMENT: (input)  This parameter specifies the identity of the system
{       element to which maintenance access is desired.  The identity of the
{       system element may be specified using either the name of the element
{       or its hardware address, if applicable.  In a multiple-IOU
{       configuration, the identity of the IOU must be supplied to uniquely
{       identify a data channel or channel-adapter.
{
{ ACCESS: (input)  This parameter specifies the kind of access which will be
{       performed by maintenance software.
{
{ STATUS: (output) This parameter specifies the request status.
{
{         CONDITIONS:
{                     cme$element_already_reserved
{                     cme$lcm_element_not_found
{                     cme$element_state_not_proper
{                     mse$ma_concurrent_access_granted
{                     mse$ma_system_critical_element
{                     mse$maintenance_job_class_req
{
{         IDENTIFIER:  'MS'
{
