HP OpenVMS Systems

Content starts here

HP Advanced Server for OpenVMS
Commands Reference Manual


Previous Contents Index


ADD HOSTMAP

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).


ADD PRINT QUEUE

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

#1

 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."

#2

 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."


ADD SHARE/DIRECTORY

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

#1

 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".

#2

 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.


ADD SHARE/PRINT

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.


Previous Next Contents Index