README1.NPS : Read Me file for NPSUTL.EXE ========================================= NPSUTL.EXE is an NPS client configuration utility using the DOS command line interface. NPSUTL provides a simple way for customers to create queue objects on or remove queue objects from the NetWare server's bindery in a NetWare 4.x coexistence environment. NetWare 4.x is NDS (NetWare Directory Services) based. It no longer uses a server-specific bindery as did previous versions of NetWare. However, the NDS system provides bindery emulation so that it is compatible with bindery-based versions of NetWare. However, there is no way to create bindery objects using NetWare 4.x client utilities. NPS only works with bindery queues. This means that you need a utility to create bindery queues on the NetWare 4.x server for NPS to use. NPSUTL is designed for this purpose. If you have both NetWare 4.x and NetWare 3.x, you can use the NetWare 3.x PCONSOLE utility to create a bindery queue on the NetWare 4.x server. If you only have a NetWare 4.x server, you have to use NPSUTL to do this. Once the bindery queue is created on the NetWare 4.x server, you can use the NetWare 4.x PCONSOLE utility to manage the bindery queues on the server. NPSUTL allows you to do the following: • Show NetWare server information • Create bindery queue on the specified server • Remove bindery queue from the specified server • Show the bindery queue information on server The steps to use this utility: 1. If you used the INST4NWU (NetWare Services Utilities installation program) to install the NPS utilities, skip to step 2. Copy the NPSUTL.EXE file to your working directory. It could be on your local disk or on the NetWare mapped drive. For example, you can use the SYS:\SYSTEM directory on your NetWare server. Remember to set the directory as an executable path. 2. Log in to the NetWare server as SUPERVISOR. The server MUST be a NetWare 4.x server and NOT an FSS server. 3. Run NPSUTL at the DOS prompt without any parameters. A help message that can help you start appears on the screen. The help message looks like this: NPS client utility V1.04B Copyright Process Software Corporation, 1996. NPSUTL Usage: NPSUTL /CMD ------------------------------------------------------------- CMD can be one of the following: SERVER_INFO -- show the server information CREATE_QUEUE-create a queue object on the server REMOVE_QUEUE-remove a queue object from the server SHOW_QUEUE -- show specified queue property on the server P1 : Server Name; P2 : Queue Name; P3 : Queue Directory (Option, default is SYS:SYSTEM); ------------------------------------------------------------- To use the utility correctly, you must log in as ADMIN or SUPERVISOR or a user who has supervisor's rights on the specified server. Note: • FSS and RPR are members of the TCPWARE products family. • The newly created queue has the initially empty queue properties Q_USERS and Q_OPERATOR. You can use PCONSOLE to add the member to it. • The Queue Directory is created in SYS:SYSTEM if you do not define a path from the command line. • When you input a command (such as /SERVER_INFO), you can abbreviate it to as little as three characters (e.g., /SER). ============================================================================ NPS Workshop: ============= In this section, we will give some examples to demonstrate how to set up an NPS printer on a NetWare 4.x server. Two conditions are required before trying similar procedure: >> NPS must be installed correctly on the VMS node >> A NetWare 4.x server and a VLM client station were set up General Setup Steps: -------------------- 1. Use NPSUTL to create a bindery queue on the NetWare 4.x server. 2. Use NetWare 4.x PCONSOLE to: > add specified users who can use the queue to the user list of the queue. > add the queue to a PSERVER and assign the queue a printer. 3. Reload PSERVER from the NetWare server's console and log in as the queue user to print a sample file to the queue from the workstation. 4. Run NPSCP from the VMS station to set up an NPS printer. 5. Print a sample file from VMS to the printer that services the queue. Examples: --------- In the following examples, indra is a NetWare 4.1 server and lambda is a VAX station run VMS v5.5. The steps refer to the General Setup Steps above. Step 1 Example (on the NeWare 4.x server): C:>NPSUTL /create indra NW_Q1 C:>NPSUTL /show indra NW* Queue Name=NW_Q1, Queue Type=03, Queue ID = A000012 Queue Name=NW_QQ, Queue Type=03, Queue ID =20000012 Step 4 Example (on the VMS station): >----- start npscp -----< (Lambda) $ npscp Initiating connections to Network Print Services and Queue Services Gateway Loading Network Print Services configuration NPSCP> >----- show NetWare queue -----< NPSCP> sho queue Enter NetWare server name: indra Enter show queues option: NW Server NW Queue --------- -------- INDRA LAB INDRA NW_Q1 >----- show status -----< NPSCP> show status Network Print Services Interface mode = Verbose Access level = Supervisor Network Print Services state = Running Queue Services Gateway state = Running Authorized connections = 5 Established connections = 1 >----- one way to create nps connection -----< NPSCP> create conn VMS_Q1 indra NW_Q1 /user=supervisor /password=cover NPSCP> sho status Network Print Services Interface mode = Verbose Access level = Supervisor Network Print Services state = Running Queue Services Gateway state = Running Authorized connections = 5 Established connections = 2 NPSCP> >----- another way to create nps connection -----< NPSCP> create conn Enter VMS queue name: VMS_Q1 Enter NetWare server name: indra Enter NetWare queue name: NW_Q1 Enter create connection option: /user=supervisor Enter create connection option: /password=cover Enter create connection option: NPSCP> >----- show connection -----< NPSCP> sho conn VMS_Q1 Enter show connection option: VMS Queue NW Server NW Queue Status --------- --------- -------- --------- VMS_Q1 INDRA NW_Q1 Connected NPSCP> >----- exit npscp and save the configuration -----< NPSCP> exit Update Network Print Services permanebt configuration? y Saving Network Print Services configuration NPSCP normal termination (lambda) $ Step 5 Example (on the VMS station): (lamdda) $ print/queue=VMS_Q1 sample.txt Job SAMPLE (queue VMS_Q1, entry 5) started on VMS_Q1 (lambda) $ ============================= End ==============================