ADDOPTSVR (Add Optical Server)
ADDOPTSVR Command syntax diagram
Purpose
The Add Optical Server (ADDOPTSVR) command enables OS/400, using the hierarchical file system (HFS) APIs, to access a remotely attached optical server. This command retrieves a list of optical volumes in each server and adds them to the optical index database allowing the volumes to be accessed using the HFS APIs. If a remote optical server is already enabled, you can use this command to refresh the volume list for that server.
Restrictions
- You must have *USE authority to use this command. It is shipped with *EXCLUDE public authority.
- To use a remote optical server, the users must have the library that contains the communications side information for that destination in their library list.
Required Parameters
- CSI
- Specifies the communications side information object name of the optical server to be added to the optical configuration. The communications side information object name is also referred to as the optical server name or the optical destination name. A maximum of 16 qualified names of servers can be specified.
The name of the communications side information object can be qualified by one of the following library values:
*LIBL: All libraries in the job's library list are searched until the first match is found.
*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the name of the library to be searched.
communications-side-information-object-name: Specify the name of the communications side information object representing the optical server.
Example for ADDOPTSVR
ADDOPTSVR CSI((QGPL/LAN01))This command enables OS/400 to access the optical server defined by the communications side information object name LAN01 in library QGPL.
Error messages for ADDOPTSVR
*ESCAPE Messages
- OPT0125
- Command &1 completed with errors, more information in job log.
- OPT6712
- Remote optical server volume list rebuild failed.