Sun Solaris Client Readme

Contents

IBM(R) Infoprint(R) Manager Sun Solaris Client Readme

  • Purpose of this client
  • Files included in this package
  • Installation directions
  • Supported Infoprint commands
  • Security
  • Examples
  • Trademarks

    • IBM(R) Infoprint(R) Manager Sun Solaris Client Readme

    This file describes the installation, configuration, and use of the IBM Infoprint Manager Sun Solaris client.

    Purpose of this client

    The IBM Infoprint Manager Sun Solaris client enables users of Sun Solaris 2.5.1 and above to issue Infoprint commands over a TCP/IP-connected network to an Infoprint Manager for AIX(R) or Infoprint Manager for Windows(R) server. Using a UNIX(R) command line or shell script, you can query server, printer and print job status; change the state of a server, printer or print job; create, delete or reorder a print job on the the server. This Readme file contains a complete list of Infoprint commands available on the command line, under Supported Infoprint commands.

    Files included in this package

    The Sun Solaris client package includes the following files:

    Installation directions

    1. Log in as root.
    2. Create a directory called /usr/lpp/pd/bin on the Solaris client system. This directory must have approximately one megabyte of available storage.
    3. Copy the pdcommand.solaris.251 file from the Infoprint Manager Common Client CD-ROM to the /usr/lpp/pd/bin directory.
    4. Run locale to determine the value of the LC_MESSAGES environment variable. Make a note of the value.
    5. Copy the ipr.cat file from the Infoprint Manager Common Client CD-ROM to the /usr/lib/nls/msg/locale directory, where locale is the value that you saved in Step 4.
    6. Change to the /usr/lpp/pd/bin directory.
    7. Type the following command: 
      mv pdcommand.solaris.251 pdcommand
    8. Create links to the pdcommand for each supported command that you wish to make available. See Supported Infoprint commands for the names of the supported commands. For example, to support the pdls command, which lists information about Infoprint objects, type the following command: 
      ln -s pdcommand pdls
    9. Create a shell script in the language of your choice or manually set the following environment variables:

      PDHOST
      The name of the host where the Infoprint Manager server resides.

      PD_SOCKET
      The TCP/IP socket number of the Infoprint Manager server. The default socket is 6874. Use 6874 unless your system has been specifically set up differently, or you have more than one Infoprint Manager server running on the host.

      PDPRINTER
      The default logical destination in the Infoprint Manager server. The commands will use this value if you do not specify a logical destination on the command line.

      PATH
      Add the /usr/lpp/pd/bin directory to the value of this variable.

      NLSPATH
      The path for the message catalog.

      The following example shows a C shell script to set the environment variables: 

      setenv PDHOST "hostname-of-infoprint-server"
setenv PD_SOCKET "6874"
setenv PDPRINTER "name-of-default-logical-destination"
setenv PATH $PATH:/usr/lpp/pd/bin
setenv NLSPATH=/usr/lib/nls/msg/%L/%N:
    10. Test the system:
      1. Open a command line window.
      2. Set the environment variables as directed in Step 9 , either manually or using a shell script.
      3. Issue one of the chosen commands, followed by -h, to display the syntax of that command and verify the installation. For example: 
        pdls -h
      4. Arrange for all users of the Sun Solaris client to set the environment variables as directed in Step 9 whenever they log in. You can use either of these methods:
        • Set the environment variables in the default shell configuration file, either individually or by invoking the shell script.
        • Tell each user to set the environment variables in his or her own shell configuration file, either individually or by invoking the shell script.

    Supported Infoprint commands

    The Sun Solaris client supports the following Infoprint Manager commands:

    For complete documentation for these commands, refer to the Infoprint Manager: Reference, S544-5475. This book can be found on the Infoprint Manager Publications CD-ROM or at http://www.printers.ibm.com/. Under Resources For, select Infoprint Manager --> Products (in the right-hand navigation bar). Then select Infoprint Manager for AIX or Infoprint Manager for Windows --> Product Resources --> Product Library. View the Infoprint Manager: Reference using Adobe Acrobat Reader or print it using an Infoprint Manager client interface.

    Information about the Infoprint commands is also available as man pages. You can access these man pages by typing the following command: 

    man commandname

    Security

    Access to the Infoprint Manager server and to the Infoprint Manager commands is controlled on the system where the server is installed. For information about providing access, refer to the following books:

    These books can be found on the Infoprint Manager Publications CD-ROM or in the Product Library at http://www.printers.ibm.com/.

    Note:
    You can always use the pdpr, pdls, and pdq commands.

    Examples

    The examples in this section have been tested on a Sun Solaris 2.5.1 system with the Sun Workshop C++ 4.2 compiler.

    1. Query the status of the Infoprint server. 
       pdls -c server
      Note:
      If you have set the PDPRINTER environment variable, you do not need to include the name of your server on the pdls command.
    2. Query the status of all printers on the Infoprint server whose hostname is pauper. 
      pdls -c printer pauper:
    3. Submit a file called test.ps in the directory /users/rothman/projects/ to the default logical destination (the value of the PDPRINTER environment variable). Name the print job MyPrintJob on the Infoprint server. 
      pdpr -t MyPrintJob /users/rothman/projects/test.ps
    4. List the jobs associated with logical destination ld1. Show detailed information (-r verbose) and do not filter for particular criteria, such as the submitter ID (-F). 
      pdq -p ld1 -r verbose -F
    5. Change the job-name attribute of a print job on the server named pauper. The job number was obtained by a previous pdq command. 
      pdmod -x "job-name=NewJobName" pauper:job-id
    6. Remove a print job from its print queue on the Infoprint server named pauper. 
      pdrm pauper:job-id
    7. Print out the usage help information for the pdpr command. 
      pdpr -h

    Trademarks

    The following terms, used in this publication, are trademarks of the IBM Corporation in the United States or other countries or both:

    AIX(R) Infoprint(R)
    IBM(R)

    Microsoft(R) and Windows are registered trademarks of Microsoft Corporation.

    UNIX is a registered trademark of The Open Group.

    Other company, product, and service names may be trademarks or service marks of others.