Remove Optical Server (RMVOPTSVR)

The Remove Optical Server (RMVOPTSVR) command disables the ability of hierarchical file system (HFS) APIs to access remote optical servers. The specified servers are no longer accessible to applications using the HFS APIs.

Restriction: The user must have *USE authority to use this command. It is shipped with *EXCLUDE public authority.

Parameters

Keyword Description Choices Notes
CSI Side information Values (up to 16 repetitions): Name, *ALL Required, Positional 1
VOLOPT Volume description option *REMOVE, *KEEP Optional, Positional 2

Side information (CSI)

Specifies the communications side information objects representing the remote optical servers to be removed from the optical configuration.

*ALL
All remote optical servers in the optical configuration are removed.
communications-side-information-object-name
Specify the name of the communications side information object representing the remote optical server. A maximum of 16 names of servers can be specified.

Volume description option (VOLOPT)

Specifies whether to keep the volume descriptions in the optical index database files for optical servers being removed.

*REMOVE
All volume descriptions are removed from the optical index data base files.
*KEEP
All volume descriptions are kept in the optical index database files. This allows *REMOVED volume descriptions to be displayed when using the Work with Optical Volumes (WRKOPTVOL) command.

Examples

RMVOPTSVR   CSI(LAN01)

This command removes optical LAN server LAN01 from the optical configuration. All volume descriptions are removed from the optical index database files.

Error messages

*ESCAPE Messages

OPT0125
Command &1 completed with errors, more information in job log.
OPT6730
No server can be specified when special value *ALL is used.