☜	CLOSE Draft MDC Standard					☞

8.2.7 Close

C[LOSE] postcond SP L closeargument

The order of execution of deviceparams is from left to right within a deviceparameters usage.

If there is no mnemonicspace in use for a device or the current mnemonicspace is the empty string then the implementation may allow any of the forms of deviceparam. The expr form may not be mixed with the other forms within the same deviceparameters.

In all other cases the expr form is not allowed.

devn identifies a device. (In this clause, the term device encompasses I/O devices, files, data sets, and other objects supporting Open, Use, Read, Write, and Close commands.) When environment is omitted, the value of expr denotes one device. When environment is present, the value of environment denotes one set of devices, while the value of expr denotes one member of the set. The interpretation of the values is left to the implementor. Reference to a non-existent environment causes an error condition with an ecode = "M26".

The deviceparameters may be used to specify termination procedures or other information associated with relinquishing ownership, in accordance with implementor interpretation.

When a deviceparam is encountered that contains a devicekeyword for which there is no defined meaning in the current mnemonicspace, the implementation may or may not cause an error to happen. If an error occurs, the ecode will contain ",M109,".

When a deviceparam is encountered that contains a deviceattribute for which there is no defined meaning in the current mnemonicspace, the implementation may or may not cause an error to happen. If an error occurs, the ecode will contain ",M109,".

Each designated device is released from ownership. If a device is not owned at the time that it is named in an argument of an executed Close, the command has no effect upon the ownership and the values of the associated parameters of that device. Device parameters in effect at the time of the execution of Close are retained for possible future use in connection with the device to which they apply. (See 8.3.1, which specifies an exception for output time-out.) If the current device is named in an argument of an executed Close command, $IO is given a value of the empty string.

Copyright © Standard Documents; 1977-2024 MUMPS Development Committee;
Copyright © Examples: 1995-2024 Ed de Moel;
Copyright © Annotations: 2003-2008 Jacquard Systems Research
Copyright © Annotations: 2008-2024 Ed de Moel.

Some specifications are "approved for inclusion in a future standard". Note that the MUMPS Development Committee cannot guarantee that such future standards will indeed be published.

This page most recently updated on 15-Nov-2023, 13:22:25.

For comments, contact Ed de Moel (demoel@jacquardsystems.com)