HP OpenVMS Systems

HP Advanced Server for OpenVMS
Commands Reference Manual

Adds a user account mapping between a HP OpenVMS server user account and an OpenVMS user account.

Format

ADD HOSTMAP [domain-name\]server-user-name host-user-name [/qualifier]

restrictions

Use of this command requires membership in the Administrators local group. This command is valid only for HP OpenVMS servers.

Related Commands

REMOVE HOSTMAP
SHOW HOSTMAP

Parameters

[domain-name\]server-user-name

Specifies the Advanced Server user name to be mapped to an OpenVMS user name. You can map a network user in a trusted domain to an OpenVMS user. Specify the domain-qualified user name in the format domain-name\server-user-name, such as KANSAS\DOLE, where KANSAS is the trusted domain, and DOLE is the user name of the user account defined in the trusted domain. If you omit a domain name, the user account is assumed to be defined in the domain of the server currently being administered.

An Advanced Server user can be mapped to only one OpenVMS user.

host-user-name

Specifies the OpenVMS user name to which the Advanced Server user name is to be mapped. More than one Advanced Server user can be mapped to the same OpenVMS user.

Qualifiers

/SERVER=server-name

Specifies the name of the server to which to add the host account mapping. The default is the server currently being administered.

Example

LANDOFOZ\\TINMAN>ADD HOSTMAP SCARECROW STRAWMAN
%PWRK-S-HOSTMAPADD, user "SCARECROW" mapped to host user "STRAWMAN"
      

This example adds a user account mapping for the Advanced Server user SCARECROW, to the OpenVMS user STRAWMAN, on the server currently being administered (TINMAN).

Creates an Advanced Server print queue. A print queue can be one of the following:

• Printer queue, which is a queue associated with a physical printing device (equivalent to an OpenVMS execution queue)
• Routing queue, which is a queue that routes print requests to one or more printer queues (equivalent to an OpenVMS generic queue)

Format

ADD PRINT QUEUE queue-name {/PRINTER | /ROUTE_TO} [/qualifiers]

restrictions

Use of this command requires membership in the Administrators, Server Operators, or Print Operators local group. This command is valid only to HP OpenVMS servers.

Related Commands

ADD SHARE/PRINT
CONTINUE PRINT QUEUE
PAUSE PRINT QUEUE
REMOVE PRINT QUEUE
SET PRINT QUEUE
SHOW PRINT QUEUES

Parameters

queue-name

Specifies a name for the queue to be added. The queue name may be 1 to 12 characters, where the characters are any uppercase and lowercase letters, digits, the underscore (_), and dollar sign ($).

You specify the type of queue, printer or routing, with the /PRINTER and /ROUTE_TO qualifiers, respectively.

Qualifiers

/DESCRIPTION="string"

/NODESCRIPTION

Specifies a string of up to 48 characters used to provide descriptive information about the queue. Enclose the string in quotation marks if it contains lowercase letters, blanks (spaces) or other nonalphanumeric characters. /NODESCRIPTION, the default, indicates that the description is to be blank.

/PRINTER=device-name

Indicates that the queue to be added is a printer queue, and specifies the physical device name or port to which the printer is physically connected. This is the actual OpenVMS system device, for example, OPA0, TTA2, TXA7, or LTA201. You must specify either the /PRINTER or /ROUTE_TO qualifier. Do not specify both /PRINTER and /ROUTE_TO on the same command line.

/ROUTE_TO=(print-queue[,...])

Indicates that the queue to be added is a routing queue, and specifies one or more printer queues to which to route print jobs. You must specify either the /PRINTER or /ROUTE_TO qualifier. Do not specify both /PRINTER and /ROUTE_TO on the same command line.

/SERVER=server-name

Specifies the name of the server on which to create the queue. The default is the server currently being administered.

/TYPE=printer-type

Specifies the type of printer when adding a printer queue. Do not use the /TYPE qualifier with the /ROUTE_TO qualifier. The printer-type keyword can be one of the following:

Printer-Type	Type of Printer
DL1100	DEClaser 1100
DL2100	DEClaser 2100
DL2100P	DEClaser 2100 Plus
DL2200	DEClaser 2200
DL2200P	DEClaser 2200 Plus
DL3200	DEClaser 3200
LN03	DIGITAL LN03
LN03P	DIGITAL LN03 Plus
LA50	DIGITAL LA50
LA70	DIGITAL LA70
LA75	DIGITAL LA75
LA210	DIGITAL LA210
LA324	DIGITAL LA324
LG01	DIGITAL LG01
LG02	DIGITAL LG02
LG06	DIGITAL LG06
LG31	DIGITAL LG31
LJ250	DIGITAL LJ250
FX850	EPSON FX850
FX1050	EPSON FX1050
HP_LASERJET	Hewlett-Packard LaserJet IID
PROPRINTER	IBM Proprinter
SILENTWRITER	NEC Silentwriter 2, model 290 (not PostScript)
GENERIC	All other printer types (the default)

Examples

 LANDOFOZ\\TINMAN> ADD PRINT QUEUE TOTO/PRINTER=LTA201/TYPE=DL3200 -
 _LANDOFOZ\\TINMAN> /DESCRIPTION="Dot's Printer"
 %PWRK-S-QUEADD, queue "TOTO" added on server "TINMAN"
      

This example adds the printer queue TOTO to the server currently being administered (TINMAN). The printer is connected to LTA201 and is a DEClaser 3200. The description for the print queue is "Dot's Printer."

 LANDOFOZ\\TINMAN> ADD PRINT QUEUE GLENDA/ROUTE_TO=(TOTO,WIZ) -
 _LANDOFOZ\\TINMAN>) /DESCRIPTION="Printers in the Land of Oz"
 %PWRK-S-QUEADD, queue "GLENDA" added on server "TINMAN"
      

This example adds a routing queue named GLENDA to the server currently being administered (TINMAN). The print jobs are routed to either of the two printer queues: TOTO or WIZ. The description for the print queue is "Printers in the Land of Oz."

Adds a shared directory resource to the server's share database, making the directory (the directory tree and its files) available to network users. Adding a shared directory is the default for the ADD SHARE command when you do not specify the /DIRECTORY or /PRINT qualifier. To add a shared print queue, refer to the ADD SHARE/PRINT command.

Format

ADD SHARE share-name share-path [/qualifiers]

ADD SHARE/DIRECTORY share-name share-path [/qualifiers]

restrictions

Use of this command requires membership in the Administrators, Account Operators, or Server Operators local group.

Related Commands

ADD SHARE/PRINT
MODIFY SHARE
REMOVE SHARE
SHOW SHARES

Parameters

share-name

Specifies a 1 to 12 character name used to identify and connect to the shared directory. If computers running MS-DOS will be connecting to the share, the share name should be limited to eight characters, optionally followed by a period and up to three more characters.

share-path

The path to a directory, local to the server being administered, to be shared.

Qualifiers

/DESCRIPTION="string"

/NODESCRIPTION

Specifies a string of up to 48 characters used to provide descriptive information about the shared directory. HP recommends that you limit the string length to 32 characters. Enclose the string in quotation marks if it contains lowercase letters, blanks (spaces) or other nonalphanumeric characters. /NODESCRIPTION, the default, indicates that the description is to be blank.

/HOST_ATTRIBUTES=(attribute-type[,...])

Sets host-system-specific attributes for the share, and is valid for HP OpenVMS servers only. For the attribute-type keyword, you can specify one or more of the keywords DIRECTORY_PROTECTION, FILE_PROTECTION, and RMS_FORMAT, as follows:

DIRECTORY_PROTECTION=(ownership:access[,...])
	Specifies the default OpenVMS RMS protections for subdirectories created in the shared directory. The protection of existing subdirectories is not affected.
	Specify the ownership keyword as any of the following:
	Ownership	Description
	OWNER	File owner (also applies to SYSTEM)
	GROUP	Users in same UIC group
	WORLD	All other users
	Specify the access keyword as any combination of the following:
	Access	Description
	R	Read-only access. Users can display files that they have permission to access in the directory.
	W	Write access. Users can create files in the directory, and can edit and delete files that they have permission to access. Write access implies delete access.
	E	Execute access. Users can run program files that they have permission to access in the directory.
	Owner access is also applied to SYSTEM. The default RMS directory protection is OWNER:RWED, GROUP:RWED, WORLD:RE.
FILE_PROTECTION=(ownership:access[,...])
	Specifies the default OpenVMS RMS protections for files created in the shared directory. The protection of existing files is not affected.
	Specify the ownership keyword as any of the following:
	Ownership	Description
	OWNER	File owner (also applies to SYSTEM)
	GROUP	Users in same UIC group
	WORLD	All other users
	Specify the access keyword as any combination of the following:
	Access	Description
	R	Read-only access. Users with access to the directory can display files stored there.
	W	Write access. Users with access to the directory can edit and delete files stored there. Write access implies delete access.
	E	Execute access. Users with access to the directory can run program files stored there.
	Owner access is also applied to SYSTEM. The default RMS file protection is OWNER:RWD, GROUP:RWD, WORLD:R.
RMS_FORMAT=record-type
	Specifies the OpenVMS RMS record format of files created in the shared directory.
	The record-type keyword can be one of the following:
	Record-Type	Description
	SEQUENTIAL_FIXED
		Files created in the shared directory are RMS sequential files with fixed length 512 byte records.
	STREAM	Files created in the shared directory are RMS stream format files. This is the default.
	UNDEFINED	Files created in the shared directory have no specific RMS format. The format is defined by the application writing the file.

/LIMIT=connect-limit

/NOLIMIT

Specifies the maximum number of users who can connect to the shared directory at one time. /NOLIMIT, the default, specifies there is no maximum connection limit.

/PERMISSIONS=([domain-name\]name=access[,...])

/NOPERMISSIONS

Specifies the access permissions for the directory share. These permissions control network access to the directory share, and determine which users or groups can access the shared directory, and the type of access they are allowed.

When a directory is shared, the default is to grant FULL access to everyone. This permission allows anyone to do anything they wish to any of the files or subdirectories in the directory tree. To restrict access, use the /NOPERMISSIONS qualifier. In this case, you must use the /PERMISSIONS qualifier to grant access to specific users or groups.

The permissions list (name=access) is a list of users and groups allowed to access the shared resource, and the type of access granted to each user or group. It must be enclosed in parentheses, and consists of one or more name=access pairs, where name can be any valid user or group name from this or another trusted domain, and access can be any one of the types listed in the following table.

To specify a user or group name in a trusted domain, enter the domain-qualified name (domain-name\name), such as KANSAS\DOLE, where KANSAS is the name of the trusted domain, and DOLE is the user or group name defined in the trusted domain. If you omit a domain name, the user or group is assumed to be defined in the domain of the server currently being administered.

Access	Description
NONE	Prevents any access to the shared directory, its subdirectories, and their files
READ	Allows viewing file names and subdirectory names, traversing to subdirectories, viewing data in files, and running applications
CHANGE	Allows viewing file names and subdirectory names, traversing to subdirectories, viewing data in files, running applications, adding files and subdirectories, changing data in files, and deleting subdirectories and files
FULL	Allows viewing file names and subdirectory names, traversing to subdirectories, viewing data in files, running applications, adding files and subdirectories, changing data in files, deleting subdirectories and files, changing file and directory permissions, and taking ownership of files and directories

/PERSONAL

/NOPERSONAL

Indicates that the shared directory is a personal share. Personal shares are supported on HP OpenVMS servers only. A personal share is identical to a shared directory in all ways except that it does not appear in a SHOW SHARES display by default, and is not network browsable. /NOPERSONAL, the default, indicates that the shared directory should not be a personal share.

/SERVER=server-name

Specifies the name of the server on which to add the share. The default is the server currently being administered.

Examples

 LANDOFOZ\\TINMAN> ADD SHARE/DIRECTORY RAINBOW USER1:[SHARED] -
 _LANDOFOZ\\TINMAN> /DESCRIPTION="Files of many colors"
 %PWRK-S-SHAREADD, share "RAINBOW" added on server "TINMAN"
      

This example adds a directory share named RAINBOW for the directory whose path is USER1:[SHARED]. The description for the share is "Files of many colors".

 LANDOFOZ\\TINMAN> ADD SHARE TORNADO USER1:[TORNADO_FILES] -
 _LANDOFOZ\\TINMAN> /NOPERMISSIONS/PERMISSIONS=(SCARECROW=FULL)
 %PWRK-S-SHAREADD, share "TORNADO" added on server "TINMAN"
      

This example adds a directory share named TORNADO for the directory whose path is USER1:[TORNADO_FILES]. The /NOPERMISSIONS qualifier explicitly denies access to the share to all users, which is granted by default, and the /PERMISSIONS qualifier grants FULL access to the share to the user SCARECROW.

Adds a shared print queue resource to the server's share database, making the print queue available to network users.

Format

ADD SHARE/PRINT share-name [queue-name] [/qualifiers]

restrictions

Use of this command requires membership in the Administrators, Account Operators, Server Operators, or Print Operators local group.

The /PRINT qualifier is required to specify a print share, and must follow the ADD SHARE command and precede any other parameters or qualifiers.

Related Commands

ADD PRINT QUEUE
ADD SHARE/DIRECTORY
MODIFY SHARE
REMOVE SHARE
SHOW SHARES

Parameters

share-name

Specifies a 1 to 12 character name used to identify and connect to the shared print queue. The print share name and queue name must match if the print queue is to be accessed from Windows NT, Windows 2000, Windows XP, and Windows 2003 clients. If computers running MS-DOS will be connecting to the share, the share name should be limited to eight characters, optionally followed by a period and up to three more characters.

queue-name

The name of a print queue, local to the server being administered, to be shared. If not specified, the queue-name parameter defaults to the name of the share. If queue-name differs from the associated OpenVMS queue name, define a logical to associate queue-name with the OpenVMS queue name.

Qualifiers

/DESCRIPTION="string"

/NODESCRIPTION

Specifies a string of up to 48 characters used to provide descriptive information about the shared print queue. Enclose the string in quotation marks if it contains lowercase letters, blanks (spaces) or other nonalphanumeric characters. /NODESCRIPTION, the default, indicates that the description is to be blank.

/LIMIT=connect-limit

/NOLIMIT

Specifies the maximum number of users who can connect to the shared print queue at one time. /NOLIMIT, the default, specifies there is no maximum connection limit.

/PERMISSIONS=([domain-name\]name=access[,...])

/NOPERMISSIONS

Specifies the access permissions for the shared print queue. These permissions control network access to the print queue, and determine which users or groups can access the shared print queue, and the type of access they are allowed.

When a print queue is shared, the default is to grant PRINT access to everyone. This permission allows anyone to print to the shared print queue. Use /NOPERMISSIONS if you do not wish to grant this default permission. In this case, you must use the /PERMISSIONS qualifier to grant access to specific users or groups.

The permissions list is a list of users and groups allowed to access the shared print queue, and the type of access granted to each user or group. It must be enclosed in parentheses, and consists of one or more name=access pairs, where name can be any valid user or group name from this or another trusted domain, and access can be any one of the types listed in the following table.

To specify a user or group name in a trusted domain, enter the domain-qualified name (domain-name\name), such as KANSAS\DOLE, where KANSAS is the name of the trusted domain, and DOLE is the user or group name defined in the trusted domain.

If you omit a domain name, the user or group is assumed to be defined in the domain of the server being administered.

Access	Description
NONE	Prevents any access to the printer
PRINT	Allows printing of documents
MANAGE_DOCUMENTS
	Allows holding, releasing, and deleting of print jobs, and changing the order in which jobs print
FULL	Allows printing of documents; holding, releasing and deleting of print jobs; changing the order in which jobs print; aborting and restarting of jobs being printed; pausing, continuing and purging of the print queue; changing of print queue settings; removal of the print queue; and changing of print resource permissions

/SERVER=server-name

Specifies the name of the server on which to add the share. The default is the server currently being administered.

Example

LANDOFOZ\\TINMAN> ADD SHARE/PRINT TOTO TOTO_LA210 -
_LANDOFOZ\\TINMAN> /DESCRIPTION="LA210 printer on TINMAN"
%PWRK-S-SHAREADD, share "TOTO" added on server "TINMAN"
      

This example adds a print share named TOTO for the print queue called TOTO_LA210. The description for the share is "LA210 printer on TINMAN". This print queue will be accessed by Windows 3.1 and MS-DOS clients only, thus the print share name can differ from the print queue name. The print share name and queue name must match if the print queue is to be accessed from Windows NT, Windows 2000, Windows XP, and Windows 2003 clients.